Overview
Pattern alerts allow users to create dynamic alerts based on machine learning regression models applied to a sensor metric. The model learns the historical time-dependent behavior of the data and computes an expected range based on a selected confidence interval. Alerts are triggered when new observations fall outside this statistically derived range.
Adding or editing a pattern alert
Adding or editing alerts can be accomplished from the Alerts dashboard page.
1. Adding a new pattern alert
From the Alert dashboard, select the "Add Alert" button in the upper left corner. You will then be prompted with the new alert configuration page below. If an alert with a similar configuration is already set up, the user can copy it to begin configuring a new alert.
1- Alert Name: Input the desired name of the alert being configured.
2- Alert Type: Select "Pattern" in the type selector.
3- Trigger Priority: Click on the Priority Bar to assign a criticality to the alert. Options include Low, Moderate, High, and Critical. This priority will determine the alert's color tone when triggered and the symbol on the Alert Summary card.
4- Sensor Selection: Click on the sensor selection bar to open the Sensor Selection window, and then pick your metric and unit of choice.
5- Time zone: Select the timezone for communications when the alert is triggered.
6- Pattern rules: Once a sensor is selected, this section expands to allow
a- selection between the existing machine learning regression patterns on that sensor, or
b- creating a new one:
a- Select the machine learning method. Auto will detect the best method based on data properties.
b- Select the data time range that the pattern is based on.
c- Select the sampling interval of the data for creating the pattern.
d- Select the confidence value that sets the width of the confidence interval.
e- Cancel or create the pattern.
For more information on these parameters, please see the patterns documentation: regression patterns and machine learning method selection.
7- Threshold percentage: A tolerance buffer defined as a percentage of the confidence band's width. It allows data points to deviate outside the expected pattern without triggering an alert. Adjusting this percentage instantly updates the visible alarm zone on the preview graph. Setting a threshold in alerts does not affect the original pattern's confidence band.
8- Trigger Frequency: This allows the user to select how the Alert behaves when triggered. "Trigger once" allows the alert to be triggered only once until it is acknowledged. "Continuous trigger" will result in the alert being triggered repeatedly until the sensor begins reporting or the alert is disabled.
9- Auto acknowledge: Enabling the auto-acknowledge toggle will allow the alert to trigger and then automatically acknowledge itself to be tripped again. The sensor trigger event will still be recorded, and notifications and emails will be sent.
10- Preview: You can see a preview of the data and pattern in this section:
11- Actions: Clicking "Add new action" lets you configure automated responses for when an alert triggers. You can choose from five actions:
- Set power mode: Switch selected Threads to "Always On."
- Set sampling rate: Change the data collection frequency for specific sensors.
- Take a photo: Trigger a configured field camera to capture an image.
- Toggle relay: Open or close a selected relay device.
- Generate report: Automatically distribute a pre-configured report.
12- Sharing: Alerts, by default, will only send emails to the user who created the alert. If you would like to enable emails to be sent to other users, you can click on the Sharing Settings and select each user to whom you would like to send an email. Emails can be toggled on or off by clicking the envelope next to each user's name.
2. Editing an existing pattern alert
From the Alert dashboard, scroll to the Alert Summary card and click on the Alert to be edited. Within the Alerts Details page, click on the Icon.
Alert summary page
This page offers similar functionalities to other types of alerts when a pattern alert is created.
1- Quick actions: This section offers common alert functionalities such as testing/editing/deleting the alert, etc.
2- Alert trigger history: This section provides a history of this alert's triggers with relevant information on the sensor's observation and pattern values at the trigger time.
3- Pattern information: This section provides information on the pattern that was used to configure this alert.
4- Alert preview: A preview of the sensor data and alert zone.