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.

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.

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.

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.

The following fields appear in this step:

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.

The following fields appear in this step:

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

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.

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

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.

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.

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.

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:

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.

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.