Overview

Data Alerts allow the user to define a minimum and/or maximum threshold value for sensor data that will trigger an alarm when the indicated sensors data has exceeded the designated alert trigger threshold.

 

Adding or Editing an Alert

Adding or editing alerts can be accomplished from the Alerts dashboard page.

1. Adding a New Alert- From the Alert dashboard, select the "Add Alert" button in the upper right 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 this alert to begin the configuration of a new alert.

2. Editing an Existing 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. 

 

Configuring A Data Alert

This section of the article will provide an overview of how to configure a Data Alert.

1. Alert Name- Input the desired name of the alert being configured.

2. Alert Type- Select "Data" from the dropdown menu.

3. Trigger Priority- Click on the Priority Bar to assign a criticality to the alert. Dropdown options include Low, Moderate, High, and Critical. This priority will dictate the color tone of the alert when triggered and the symbol in the Alert Summary card.

4. Sensor Selection- Click on the sensor selection bar, to open the Sensor Selection window illustrated below. Select the desired sensors by clicking on the sensor name within the left "Available Sensors" column, moving that sensor to the "Selected Sensors" column.  

5. Alert Rules- The trigger alert rules dictate the data metric and value threshold that will trigger the alert. Clicking the "Add new rule" button will open the Edit rule window illustrated below. Drop-downs along the upper portion of the window control the trigger rule being configured. From left to right, the user can select the metric for the trigger, define the criteria as above or below the threshold, input the threshold value, and select the unit of the metric threshold value. The window also displays a graph so the user can compare historical measurements to the configured alert thresholds. Clicking "Save" at the bottom of the window will apply the configured rule to the alert. 

  

6. Edit/Delete Alert Rules- After Alert Rules have been configured, they will appear above the "Add new rule" button. Clicking the pencil icon will re-open the "Edit rule" window to change the alert rule. The trash can icon will delete selected alert rule.

7. Alert Criteria- The Alert Criteria drop-down allows the user to specify if only one or all Alert Rules must be met for the alert to be triggered.

8. Trigger Frequency- This dropdown allows the user to select how the Alert behaves when triggered. "Trigger once" will only allow the alert to be triggered once until the alert is acknowledged. "Trigger per sensor" allows the alert to be triggered once for each sensor selected in the configuration before the alert is acknowledged. "Continuous trigger" will result in the alert to be triggered repeatedly until the sensor begins reporting or the alert is disabled.

9. Alert Verification- The Alert Verification toggle allows the user to select the option for two consecutive measurements to be collected that exceed the alert threshold in order for the Alert to be triggered. This feature is helpful if sensor data is inconsistent and causes false alert triggers.

10. Auto-Acknowledge- Enabling the auto-acknowledge toggle will allow the alert to trigger and then automatically acknowledge itself in order to be tripped again. The sensor trigger event will still be recorded and notifications and emails will be sent.

11. Alerts Actions- Clicking the "Add new action" icon will open a window with dropdown with five configureable action options that will automatically be completed when an alert triggers. The list below outlines the five action options. 

• Set connection power mode- Allows the user to turn selected Threads to "Always On" power mode.
• Set sampling rate- Allows the user to select sensors and adjust the sampling rate of these sensors.
• Take a photo- If field cameras are configured, the user can select a field camera to take a picture upon alert trigger.
• Toggle relay device- The user can select a relay device to toggle and the toggle option open or close.
• Generate a report- A previously configured report can be selected from a dropdown list which will be distributed on alert trigger.

12. Emails - Alerts, by default, will only send emails to the user that 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 that you would like to receive an email. Emails can be toggled on or off by clicking the envelope next to each users name.

13. Create- Finalize the alert configuration by clicking the "Create" button.

Sharing A Data Alert

Once an alert has been created, you can now navigate back to the alert configuration page to edit the users that are shared with this alert. To do this, alert summary card and select the  icon to open the edit configuration page. 

At the bottom of the alert configuration page you will find the Sharing section. In this section you will be able to see if the alert is private or restricted, and what users have access to the alert. You can click on the  button to edit the shared users. 

1. Private Sharing - By default all alerts are set to private until they are shared, when an alert is private it is only visible to the original creator of the alert profile. 

2. Restricted - By selecting Restricted, you can choose the users that you would like to have access to the alert by using the search bar.

3. Project wide - Project wide will give all users on the project access to the alert. 

3. Unchecking the box next to a user will remove their access to the alert. 

4. Click the apply button to save your changes. 

Additional Alert Options

After an alert has been created, navigating back to the alert will allow additional configuration options. Click on an alert in the Alert Summary card to access these additional options. 

1. Test Alert- Clicking the "Test Alert" icon will send an email test to the user to allow confirmation that the user is receiving alert emails.

2. Edit Alert- Clicking the edit icon will open a pop up window that allows you to change any of the configuration details of the alert mentioned in the section above. 

3. Delete Alert- Clicking the trash can icon will open a pop-up window allowing the user to delete the alert.

4. Open Issues- Clicking on the flag icon will take you to the Issue's Resolution page. Learn more about this module here.

5. Open in Digital Twin- Clicking on the cube icon will allow you to view this alert within the context of the digital twin module. 

6. Enable/Disable Alerts- Alerts can be enabled or disabled from the Details page after navigating to an alert. A drop-down in the upper-left bar below the alert name will allow the user toggle the alert on or off.