Anomaly Detection Alerts

Anomaly detection helps you spot unusual changes in time-based metrics and get automatically notified. This is useful when you want to monitor key KPIs without manually checking dashboards.

What Anomaly Detection Does

When enabled for a metric, the system looks at the metric over time and finds values that are unexpectedly higher or lower than usual. It considers:

• overall trend (values going up or down)
• repeating patterns (seasonality), such as weekly or yearly cycles
• sudden changes that do not match the expected pattern

When an anomaly is detected, you receive an alert so you can investigate.

Who Can Use It

You need access to both:

• Alerts
• AI Assistant features

Create an Anomaly Detection Alert

1. Open a dashboard and find a visualization with a trendable metric.

2. Open the visualization menu and go to Alerts, then select Create.

3. In the setup dialog:

   • Select the metric to monitor. If the visualization has multiple metrics, the first metric (in alphabetical order) is selected by default.
   • Select Aggregate by (day, week, month, quarter, year). By default, this matches the granularity used in the visualization.
   • Optionally, add filters (for example Country = US).
   • Select sensitivity: low, medium (default), or high.

4. Choose what happens when an anomaly is detected (notify via email or other available destinations).

5. Confirm to create the alert.

Notes:

• The system uses up to the last 5 years of history by default. If less history is available, it uses what exists.

• If there is not enough data to evaluate anomalies (for example, too few data points), alerts are not triggered until enough history is collected.

• If some data points are missing, the system automatically fills them in using the median value of your available data. This ensures the analysis can continue even with incomplete data.

• Seasonality is calculated statistically and automatically selected. The system uses a single seasonality level that is higher (coarser) than the monitored metric’s granularity. It does not combine multiple seasonalities.

  Mapping used (metric’s granularity → seasonality):

  • day → week
  • week → month
  • month → year
  • quarter → year
  • year → no seasonality

• Date range filters are not used for anomaly detection.

How Often Checks Run

Checks run based on the selected granularity:

• daily checks evaluate the previous day
• weekly checks evaluate the previous week (after the week ends)
• monthly checks evaluate the previous month, and so on

Create Anomaly Detection Alerts With AI Assistant

You can also create and schedule anomaly detection alerts using the AI Assistant.

• The AI Assistant supports the same alert setup workflow as manual alerts (metric, schedule/granularity, destination, recipients).
• If you do not specify the granularity (or it can’t be inferred), the Assistant asks follow-up questions.

Example prompts:

• Notify me if there is any suspicious activity on this metric daily.
• Let me know if any anomalies are detected in weekly numbers.
• Set an anomaly alert on Total Sales.
• Monitor Total Sales for anomalies daily.
• Create a scheduled anomaly check for Total Sales.
• Run anomaly detection on Total Sales every day.
• Ping me when Total Sales behaves oddly.

Anomaly Notifications

If an anomaly is found, you receive a notification through the selected channel. The message includes:

• alert name
• metric name
• granularity (how often it is checked)
• time period

• actual value

• applied filters (if any)
• link to open the dashboard or visualization

Example:

• Metric: Net sales
• Frequency checked: weekly
• Period: Week 42 / 2025

• Actual value: 155K

• Filters: Country = US
• Triggered at: 12.11.2025 11:00 CET
• Link: open dashboard