Alerts are designed to notify users of device and sensor statuses and update the user with critical sensor data via real-time notifications and emails. The user can also select actions that perform different functions if an alert is triggered. To navigate to Alerts, click on the "Alerts" icon on the upper banner. This article will review the basics of alerts and navigation of the "Alerts" Page. For details regarding the setup of alerts, please visit the support article of the relevant alert type you wish to create within the Alerts Section.
This section of the article will explain the basic elements and configuration options of alerts.
There are two different types of alerts, Data and Status. Data Alerts notify the user when reported sensor data surpasses a user-defined minimum or maximum sensor data value threshold. Status Alerts notify the user when Connections, Devices, or Sensors have not responded in a set amount of time. Click the links to learn more about what each does and how to set each one up (link).
Enabled- An enabled alert is set, but the alert is currently not triggered.
Disabled- The user can disable an alert, which will not allow the alert to be triggered.
Triggered- The threshold value of a data alert or the non-reporting interval of a status alert has been triggered.
Snoozed- A triggered alert has been set by a user to not continue to trigger or send alerts for a user-determined amount of time.
When configuring a new alert or editing an existing alert, the user can select the color-coded criticality of the alert. The user can sort by Alert Priority on the Alerts page, and the Alert will be highlighted with its alert priority color upon triggering. Below is a chart with the color scheme assigned to each priority level.
Alerts Page Navigation
The alerts page allows the user to view all alerts on the project, create alerts, filter alerts, and manage certain elements of the alerts. This section of the article will review the navigation and editing functions built into the Alerts Page.
1. Create Alert- Click on the icon to be navigated to the new Alert creation page.
2. Alert Status Count and Filter by Status- The blue bubbles indicate the number of alerts that are currently triggered, snoozed, or disabled. Clicking on the status name or the blue bubbles will enable a filter that only displays alerts with the selected status.
3. Type and Priority Filters- Clicking either on the filter options will expand dropdowns, as illustrated below, for each filter option, allowing the user to view only the selected alert type or selected priority level on the Alerts Page.
4. Search Alerts- The user can search created alerts by a keyword within the name, alert type, alert status, and alert priority.
5. Sort By- Alerts can be sorted by a number of metrics listed in the screenshot below.
6. Alert Sharing- Clicking the opens up the sharing options window for an alert. The below window will open and the user can select the sharing option they prefer.
7. Delete Alert- The user can delete an alert by clicking on the icon.
Enabled and Disabled Alerts
Enabled alerts will be displayed in white on the Alerts page. Disabled alerts will be displayed in grey on the Alerts page. Hovering over an enabled or disabled alert will trigger a toggle switch icon to appear, allowing the user to change the alert to enabled or disabled.
If an alert is a highlighted color within the Alert Page, it means that the Alert has been triggered. The highlighted color will correspond to the alert priority. If an alert is triggered, several control options become available from the Alert page.
1. Acknowledge Alert- This button will reset the trigger on the alert and send the alert back to enabled mode.
If the alert is set to trigger once, acknowledging the alert will allow the alert to be triggered again. In some instances, an alert cannot be acknowledged if it will automatically be triggered again due to the trigger criteria still being met.
2. Snooze Alert- The user can select a period of time to disable the alert, meaning the alert cannot be triggered for the selected period of time.
3. Disable Alert- This alert will be turned off and unable to be triggered again until a user enables the alert again.
Multi-Alert Selection Options
Within the alerts page, a user can select multiple alerts simultaneously by clicking on the white check box to the left of each alert. Additional options will appear on the upper bar of the Alerts page.
1. Alert Selection- Clicking into the white box will turn the box blue with a white check mark after selection. After making selections, additional configurrations options will appear along the upper alerts bar.
2. Enable Alerts- Clicking will turn the selected alerts on.
3. Snooze Alerts- The user can select a period of time to disable the selected alerts by clicking , meaning the alert cannot be triggered for the selected period of time.
4. Disable Alerts- Clicking will be turn off all of the selected alerts. These alerts cannot be triggered again until a user enables the alerts again.
5. Share Alerts- Clicking the opens up the sharing options window for the selected alerts. The below window will open and the user can select the sharing option they prefer.
6. Delete Alert- The user can delete the selected alerts by clicking on the icon.
Alerts Configuration Page Overview
Clicking on an alert from the Alerts Overview page will open the Alerts Configuration page. The main point of alert configuration are covered within the Data Alerts and Status Alerts pages. Additional configuration options, as illustrated below, will be covered in this section of this article.
1. Alert Actions- Depending on the status of the alert, the user will have options to Enable, Disable, Snooze, or Acknowledge the selected alert.
2. Test Alert- Clicking on the "Test Alert" button will send a test email to all users that this alert is shared with so that the user can confirm that the alert email is functioning properly.
3. Alert Sharing- Clicking the icon opens up the sharing options window for an alert. The sharing window will open, as outlined in the previous portion of this article, and the user can select the sharing option they prefer.
4. Delete Alert- The user can delete an alert by clicking on the icon.
5. Alert Notifications Toggle- This check-box toggle
6. Trigger History- Each time an Alert is triggered, details regarding the instance will be logged in the Trigger History.
Clicking on any of the Trigger instances opens the Alert Trigger Details below.