Using alerts in Explore & Present#
This guide explains how to create and configure alerts in Explore & Present, in order to notify users of anomalies in your data.
Introduction#
Set up alerts to notify yourself and/or other users by email if an anomaly is detected in your data. Anomalies are metric values outside a defined limit, and are identified based on a filter that you configure.
When a metric value is outside the limit you define, an alert notification is sent by email to the addresses you specify. Email alerts are sent at 08:00 CEST at the frequency you select.
Prerequisites#
In Explore & Present, you need Workspace Admin (WA) permissions to create and configure alerts. For more information, see Roles and permissions in Explore & Present.
Creating and configuring alerts#
To set up and configure alerts, follow these steps:
Go to the Explore page.
In the top left corner, click Select workspace, then Administration.
In the Explore section of the administration menu, click Alerts.
Existing alerts are displayed in a table.
To create a new alert, in the top right corner, click + New alert, and configure the following fields:
- Name
Enter a name for the new alert.
- Date range
Select the time period for which you want to receive alerts.
- Dimension filter
Configure a dimension filter for the alert:
In the Choose dimension drop-down menu, select the dimension by which to filter data.
In the Filter by drop-down menu, select the dimension values by which to filter data. To change the operator for a dimension value, click on the selected dimension values.
(Optional) To add another filter, click + Add filter and repeat the previous two steps for the new filter.
- Metric
Select the metric that you want to receive alerts for.
- Granularity
Select the granularity of the alert. For example, select Daily if you want the alert to search for anomalies on a day-to-day basis.
- Condition type
Select the type of anomalies that will trigger the alert:
Select Fixed boundaries to provide fixed limits. Any values outside these limits will trigger the alert. For more details, see
Select Outliers by moving mean to provide dynamic limits based on the average value of the selected metric. This means that the limits that trigger the alert will change based on your data.
- Data preview
In this section, you can see a preview of your data. The gray area on the chart represents the limits of the condition type you selected in the previous field. Data values that are outside the limits are highlighted in red.
- Frequency
Select the frequency at which you want to receive alerts:
Select Fire for every value to receive an alert for every metric outlier that is found.
Select Fire at most once to receive an alert for the first metric outlier is found.
Select Fire once for all consecutive outliers to receive an alert for every series of metric outliers. A series of outliers is a consecutive series of metric values outside the limits.
- Send as email
Enter the email addresses of all other users that will receive the alert.
Select the Send to my email checkbox to receive an alert to the email address associated with your Adverity account.
- Enable/disable alert
To create an alert without enabling it, deselect this checkbox. This checkbox is selected by default, so that all newly created alerts are enabled by default.
Click Create.
Configuring fixed boundaries#
To configure the Fixed boundaries condition type, configure the following fields:
- Lower
Enter a value for the lower limit. If you do not want a lower limit, deselect the checkbox next to this field.
- Upper
Enter a value for the upper limit. If you do not want a upper limit, deselect the checkbox next to this field.
Configuring outliers by moving mean#
To configure the Outliers by moving mean condition type, configure the following fields:
- Outlier percentage
Select the percentage boundaries for the moving mean. For example, select 10 in this field to receive alerts for any values that are 90% greater or less than the mean value.
- Use bounds
Select whether to use upper and lower limits, only upper limits, or only lower limits. By default, both upper and lower limits are used.
- Window size
Select how many values are used to calculate the mean value. The bigger the window, the more accurate and smoother the moving mean will be.
- Mean method
Select how to calculate the mean value. Choose either to use an average of all data points, or the median value of all data points.
- Cold start
Select this checkbox to calculate the mean value using all data points in the selected time period.
Deselect this checkbox to only use sets of values equal to a full window size (as selected above) to calculate the mean value. For example, if this checkbox is deselected, your data set contains 29 data points, and the window size is 5, the first two and last two data points are not used to calculate the mean value.