Analytics Alerts

Learn how to set up continuous metric monitoring and receive instant notifications when anomalies or threshold breaches occur in your analytics data.

Overview

Alerts in Analytics is a continuous monitoring feature in CleverTap that notifies you when a metric on a trendline behaves unexpectedly. Instead of checking dashboards manually, you set up an alert once, and CleverTap evaluates the metric on the specified conditions on an hourly, daily, weekly, or monthly basis and notifies you when a condition is met.

This feature is available on Trends charts and supports the following metrics:

  • Total Events
  • Unique Users

Alert Types

You can choose between two alert types:

  • Anomaly alerts: Triggered when the metric deviates from its expected range, as determined by CleverTap's seasonality-aware detection model.
  • Threshold alerts: Triggered when the metric crosses a fixed value or changes by a defined percentage relative to the same period last week.

When an alert is triggered, CleverTap delivers notifications based on the selected delivery options, such as a Dashboard Notification, Email, or a Slack channel. Each notification states the period that was evaluated and the numbers behind the alert. For more information, refer to Alert Notifications.

Alerts Evaluation Process

When you create an alert, CleverTap saves the event, filters, and metric you are monitoring as the alert's query. CleverTap then runs this query automatically at the schedule you set.

Each time CleverTap evaluates the alert, it does the following:

  • Fetches the latest metric data for the monitored event and segment.
  • Runs the detection logic (anomaly or threshold) against the latest data.
  • Triggers a notification if the condition is met and delivers it to your chosen notification channels.
💡

Tip

Choose the alert type that suits your metric. Use anomaly alerts for metrics that change frequently and unpredictably. Use threshold alerts when you have a specific value or percentage change in mind that you always want to know about.

Evaluation Periods

CleverTap evaluates alerts on calendar-aligned periods, such as a full hour, a full day, a Monday-to-Sunday week, or a full calendar month. It compares a complete period with another complete period and evaluates an alert only after the period it covers has closed. This means a partial period, such as Monday to Wednesday, is never compared with a full week.

For the time at which each alert frequency is evaluated, refer to Delivery Options.

Prerequisites

Before you create an alert, make sure you meet the following requirements:

  • You have access to the CleverTap Analytics module.
  • You have a Trends chart configured with at least one supported metric (Event count or Unique users).
  • To send alerts to Slack, a user with admin access must first connect your project to Slack. For more information, refer to Connect Slack.

Create an Alert

You can create an alert directly from a Trends chart. ​

To create an alert:

  1. Go to Analytics > Trends Beta and view a Trends analysis.
  2. Hover over a data point on the trendline you want to monitor, then click the + icon to view the selection options.
  3. Click Create alert.

Create Alert from a Trendline Data Point

The Create Alert window opens, which follows the following two-step process:

  1. Criteria
  2. Delivery Options

Criteria

The Criteria step lets you name the alert and define the condition that triggers it. This step lets you define what to monitor and how to detect a condition.

Define Alert Criteria

The following fields appear in this step:

FieldDescription
NameA label for the alert. Choose a name that clearly describes what is being monitored. For example, the charged event drop for weekdays.
Event triggerThe event and filter conditions that are being monitored. This field is pre-populated from the trendline you selected on the Trends chart and cannot be edited in the window. For example, if you selected a data point on a Charged event trendline filtered by Count greater than or equal to 1, those details appear here automatically.
Alert triggerThe type of detection to apply. You can select the following two Alert trigger types:
  • Anomaly: Triggers when the metric deviates from its statistically expected range. Choose Anomaly when you want open-ended monitoring, meaning you do not need to know in advance what value constitutes a problem. CleverTap uses historical data and seasonal patterns to calculate an expected range for the metric, including a margin of error, and triggers the alert when the metric falls outside that range.

    For example, your App Launch event typically records between 80,000 and 100,000 app launches on weekdays. On a Tuesday, app launches drop to 42,000. CleverTap recognizes this falls outside the expected range and triggers the alert.

  • Threshold: Triggers when the metric crosses a fixed value or percentage change. Choose Threshold when you have a specific value or percentage change in mind that you always want to know about. The alert triggers when the metric crosses the threshold value or percentage you define.

    For example, you want to know whenever your Charged event total drops more than 20% compared to the same weekday last week. You set the condition to Decreases by (%) and the value to 20. If the previous Tuesday's total was 5,000 and the current Tuesday's total is 3,800 (a 24% decrease), the alert triggers. If the total for Tuesday is 4,200 (a 16% decrease), no alert is triggered.

Scan mode (Anomaly only)

The detection mode that CleverTap applies. It determines how much historical data CleverTap uses to build the expected value baseline. Choose the mode based on how stable or seasonal your metric is.

For more information, refer to Scan Mode.

Confidence interval (Anomaly only)

The certainty level CleverTap uses to define the expected range, such as 99%, 95%, or 90%. A higher percentage widens the expected range, so fewer deviations trigger the alert.

For more information, refer to Confidence Interval.

Alert for (Anomaly only)Controls which direction of deviation triggers the alert. The following options are available:
  • Spike: Triggers an alert only when the metric exceeds the upper bound of the expected range.
  • Drop: Triggers an alert only when the metric falls below the lower bound of the expected range.
  • Both: Triggers an alert on both upward and downward deviations.
An alert set to Drop never triggers when the metric rises, and an alert set to Spike never triggers when the metric falls.

Use these options to reduce noise when you only care about one type of movement in your metric. For example, if you monitor a Payment Failed event and only care about spikes in failures, but a drop in failures is not a problem. Set an alert for Spike so that naturally quieter periods do not generate false alerts.

Trigger condition (Threshold only)The condition that must be met to trigger the alert. The following options are available:
  • Above: Triggers when the metric value exceeds the threshold.
  • Below: Triggers when the metric value drops below the threshold.
  • Increases by (%): Triggers when the metric increases by at least X% compared to the same period last week.
  • Decreases by (%): Triggers when the metric decreases by at least X% compared to the same period last week.
Threshold value (Threshold only)The numeric value used in the trigger condition. Enter an absolute number for Above or Below, or a percentage for Increases by (%) or Decreases by (%).

After configuring the criteria, click Next to proceed to Delivery Options.

Delivery Options

The Delivery Options step lets you configure how often CleverTap evaluates the alert and where to send the notifications.

Set Up Delivery Options for Alerts

The following fields appear in this step:

FieldDescription
Alert frequencyDetermines how often CleverTap checks whether the alert condition is met. The following options are available:
  • Hourly: Evaluates once per hour for the hour that just closed, at least 20 minutes after the hour closes.
  • Daily: Evaluates once per day at approximately 6:00 AM in your account's timezone, for the previous full day.
  • Weekly: Evaluates once per week at approximately 6:00 AM on Monday in your account's timezone, for the previous full week (Monday to Sunday).
  • Monthly: Evaluates once per month at approximately 6:00 AM on the 1st of the month in your account's timezone, for the previous full calendar month. This applies even when the 1st falls on a weekend.
Delivery destinationDefines where to send notifications. For example, Dashboard, Email, or Slack (You can also multi-select Slack channels).
Email recipientsThe email addresses to notify. You are added automatically as a recipient.
Slack channels (if Slack is connected)The Slack channel that receives the alert. Select from the available channels that the CleverTap bot has been invited to join. Slack delivery requires a one-time project-level Slack connection by an admin. If Slack is not connected, a Connect Slack button appears instead of the channel picker.

After configuring delivery options, click Create to save the alert.

💡

Note

The 20-minute delay applies to hourly alerts only. It allows event data to fully settle before evaluation runs. For example, if you set an hourly alert with an evaluation window of 3:00 to 4:00 PM, CleverTap evaluates the metric at approximately 4:20 PM once that hour is fully closed.

For all alert frequencies (hourly, daily, weekly, and monthly), CleverTap only evaluates complete, closed periods. It never evaluates a partial period. This is important when interpreting a metric value of 0. A value of 0 in a completed, evaluated period means no events occurred. It does not mean data has not arrived yet, because CleverTap waits for the period to close before running any evaluation.

Alert Notifications

When an alert triggers, CleverTap sends a notification to each delivery destination you select, such as Dashboard, Email, or Slack. Every notification tells you what was evaluated and why the alert triggered, so you can understand the change without opening the dashboard.

Evaluation Window and Breach Details

Each notification includes the following:

  • Evaluation window: The exact period CleverTap evaluated when the alert triggered. For example, Jul 6, 09:00 to 10:00 for an hourly alert, Jun 30 (full day) for a daily alert, Jun 23–29 for a weekly alert, or June 2026 for a monthly alert.
  • Metric and series: The event, segment, and metric on which CleverTap found the change.
  • Breach details: The numbers behind the alert. The details depend on the alert type:
    • Threshold alerts: The actual value, the threshold you set, and the baseline value, which is the value from the same period last week.
    • Anomaly alerts: The actual value, the expected value or range, the percentage spike or drop compared with the baseline, and the direction of the change (increase or decrease).

All timestamps in Dashboard notifications and the evaluation window labels in every notification use your account's time zone.

Dashboard Notification Alert

The following is the sample dashboard notification alert:

View Anomaly Alert on Dashboard Notification

View Anomaly Alert on Dashboard Notification

Email Alert

Email alert includes an image of the alert's chart. The image shows the metric line, the point at which the alert triggered, and the expected range (for anomaly alerts) or the threshold (for threshold alerts).

View Anomaly Alert on Email

View Anomaly Alert on Email

Slack Alert

Slack notifications include an image of the alert's chart. The image shows the metric line, the point at which the alert triggered, and the expected range (for anomaly alerts) or the threshold (for threshold alerts).

View Anomaly Alert on Slack

View Anomaly Alert on Slack

📘

Chart Generation Failure

If CleverTap cannot generate the chart image, the notification is still delivered without the image.

Manage Alerts

You can view, edit, pause, resume, and delete all alerts in your project from the Manage Alerts page.

To access Manage Alerts, go to Settings > Alerts.

View Alerts on Manage Alerts

The Manage Alerts page shows a table with the following columns:

ColumnDescription
NameThe name you specified for the alert.
StatusThe current status of the alert. The following alert statuses are available:
  • ACTIVE: The alert is running and will evaluate at its next scheduled time.
  • PAUSED: The alert is not evaluating. Its configuration is preserved. You can resume it at any time.
  • FAILING: CleverTap was unable to evaluate the alert's condition successfully three or more consecutive times. You are notified by email when this happens.
Alert triggerWhether the alert uses Anomaly or Threshold detection.
Created ByThe email address of the person who created the alert.
Created OnThe date the alert was created.

Edit

To edit an alert's criteria or delivery options:

  1. On the Manage Alerts page, hover over the alert you want to edit.
  2. Click the edit icon.
  3. The Edit alert window opens with your existing settings pre-filled.
  4. Update the fields you want to edit.
  5. Click Save changes to confirm.

Editing an Active Alert

Pause

Pausing an alert temporarily stops it from evaluating. The alert configuration is preserved, and you can resume it later. Use this when you want to stop receiving alerts during a known period of unusual activity, such as a major product launch or a marketing campaign, without losing the alert configuration.

To pause an alert:

  1. On the Manage Alerts page, hover over the alert you want to pause.
  2. Click the ellipsis icon.
  3. Click Pause from the list.
  4. Click Pause to confirm.

Pausing an Active Alert

To resume a paused alert, follow the same steps and click Resume in the ellipsis menu.

Delete

Deleting an alert permanently removes it and its notification settings. This action cannot be undone.

To delete an alert:

  1. On the Manage Alerts page, hover over the alert you want to delete.
  2. Click the ellipsis icon.
  3. Click Delete from the list.
  4. Click Delete to confirm.

Deleting an Active Alert

Connect Slack

Connecting Slack allows any alert in your project to deliver notifications to a Slack channel. This is a one-time, project-level setup that requires admin access.

Prerequisites for Slack Connection

  • You must have admin access to your CleverTap project.
  • You must have permission to install apps in your Slack workspace.

Connect Your Slack Workspace

To connect Slack:

  1. Open the Delivery Options step from the Create Alert window.
  2. Click Connect Slack. You are redirected to Slack's authorization page to grant CleverTap the requested permissions.
  3. Select or enter the name of your Slack workspace.
  4. Click Submit Request.

Once connected, any alert in your project can route notifications to any Slack channel to which the CleverTap bot has been invited.

Project Limits

The following limits apply to Alerts:

LimitValue
Active alerts per project10
Supported metricsTotal Events and Unique users only
Alert typesAnomaly and Threshold
Threshold percent-change baselineSame period last week only
💡

Alert Limits Per Project

When you reach the 10-alert limit, the Create alert option is disabled. To create a new alert, go to Manage Alerts and delete or pause any active alerts first. Paused alerts do not count toward the 10-alert limit. Only alerts with ACTIVE status count against the project limit.

FAQs

Find answers to the following common questions about Alerts in Analytics.

What does the alert frequency control?

The alert frequency determines how often CleverTap evaluates the alert. Hourly evaluations check the metric every hour, daily evaluations check once per day, and so on. Choose a frequency that matches how quickly you need to respond to a change in the metric.

What is the baseline for percentage-change threshold alerts?

The baseline is always the same period from the previous week. For example, if your alert evaluates on a Wednesday, CleverTap compares Wednesday's value to the previous Wednesday's value. This applies regardless of whether your alert frequency is set to Hourly, Daily, Weekly, or Monthly. The comparison always looks back to the equivalent period one week prior. Comparison with any other period, such as the previous day or month, is not supported. This keeps comparisons consistent with the weekly seasonality patterns common in most product metrics. CleverTap always compares complete periods, such as a full day with a full day, so a partial period is never compared with a full one.

Can I receive alerts on multiple channels at once?

Yes. You can select any combination of Dashboard, Email, and Slack as delivery destinations for each alert.

What happens to Slack alerts if I disconnect Slack?

Slack delivery is paused on all existing alerts. Dashboard and email notifications for those alerts continue to trigger.

Why is my alert showing as FAILING?

An alert enters FAILING status when CleverTap is unable to evaluate the alert's condition successfully three or more consecutive times. This can happen due to a temporary system error. You receive an email notification when this happens. If the alert continues to fail, contact CleverTap Support.

I set an anomaly alert, but it is not triggering even though I can see a clear drop on my chart. Why?

The anomaly algorithm may not have flagged the drop if it falls within the expected range. Try editing the alert and lowering the Confidence Interval to 90%. This narrows the expected range and makes the alert more sensitive. For more information, refer to Confidence Interval.

Can I edit a monitored event or metric after creating an alert?

No. The event, filters, and metric are saved when the alert is created and cannot be changed afterward. To monitor a different event or metric, delete the existing alert and create a new one.

What time period does a notification cover?

Every notification states the evaluation window, which is the exact period CleverTap evaluated. For example, a daily alert that triggers on the morning of July 1 covers the full day of June 30. For more information, refer to Alert Notifications.

Which timezone do alert notifications use?

Dashboard notification timestamps and evaluation window labels use your account's time zone.

Why does the chart image not appear in an older alert email?

CleverTap stores chart images for 30 days. After that, the image in an older email may no longer be displayed. To see the chart, click View Chart in the notification.


Did this page help you?
Suggest Edit
CleverTap Ask AI Widget (CSP-Safe)