Getting Started: Alerting

Contents

  1. Introduction
  2. Inserting Data
  3. Portals
  4. Exporting Data
  5. SQL
  6. Alerting

Creating Rules

Open the Alerts > Rules page and click Create to configure an alert rule for the temperature metric using the Rule Engine.

The following condition evaluates to true and creates an alert if the average value for the last three samples exceeds 50:

avg() > 50

Open the Filter tab in the rule editor to allow out-of-order values and to disable the Time Filter by setting the grace interval to 0. Otherwise the rule engine ignores measurements timestamped earlier than 1 minute from current time.

Import the rule from XML file temperature_rule.xml.

Return to Data Entry and submit a few commands with values greater than 50.

series e:br-1905 m:temperature=55

Open the Alerts > Open Alerts page in the main menu to view currently opened alerts.

Now, insert some commands with lower values to ensure that the average of the last three commands is less than 50.

series e:br-1905 m:temperature=20

Refresh the Open Alerts page to verify that the alert for temperature-too-high is closed.

Email Alerts

To receive alert notifications via email, configure the Mail Client on Settings > Mail Client.

Open the rule editor and enable alerts on the Email Notifications tab as illustrated below.

Note

To enable sending portal screenshots, configure the Web Driver.

Save the rule and insert a few samples on the Data Entry page again. ATSD sends the following message when the threshold is exceeded:

Slack Alerts

To receive alerts in Slack create a bot user and configure the SLACK webhook.

Open the rule editor and enable alerts on the Webhooks tab as illustrated below.

Save the rule and insert commands on the Data Entry page again.

The following message appears in Slack when the average exceeds 50 for the last three samples.

Refer to Outgoing Webhooks for more details.

Summary

Congratulations!

You have successfully completed the Getting Started Guide for ATSD.

Review Use Cases for Research Articles, Integration Guides, and advanced Tutorials to make the most of your new database.