Creating and editing Alert Rules

Last updated: Fri Nov 16 13:38:23 GMT 2018

The following article describes the steps in adding or editing an Alert Rule. To understand how alerts work, refer to the ThousandEyes Knowledge Base article How Alerts work. Under the Settings, click on Alerts > Alert Rules to open the Alert Rules page and then click on +Add New Alert Rule. The Add New Alert Rule panel will appear.


Highlighted areas on the page are documented in the following list:

  1. Layer: test layers available to your organization are shown in a ribbon at the top of the page. 
  2. Alert Type: available alert types for the highlighted test layer.
  3. Rule Name: the name of the Alert Rule.
  4. Tests: a drop-down menu listing the all the tests set up in your account group.  Select one or more tests to assign them to this alert.
  5. Agents: Select the Agents to which you will assign this Alert Rule.  The options are:
    • All agents: All Agents will be assigned this Alert Rule
    • All agents except: All Agents will be assigned this Alert Rule except for the ones selected
    • Specific agents: Only selected Agents will receive this Alert Rule
  6. Specify the number of agents, all/any of the alerting conditions, and the number of test rounds (out of how many rounds) the conditions must be met before alerting.
  7. Alerting Condition: alert conditions, particular to the selected test type which must be met in order to trigger the alert. For a list of alerting conditions, refer here
  8. Compatible Test Types: lists the test types to which this Alert Rule can be assigned.
  9. Notifications: Tab to configure the settings for receiving alert notifications.  See listing and graphic below.


  1. Send emails to: choose from the pull-down list of email addresses that should receive the alert notification.
  2. Edit emails: link to create a new email address in order to add it to the Send emails to field.
  3. Send an email when alert clears: if checked, an email is sent when the alert condition clears.
  4. Add message: an optional field for text that will be sent in the body of the alert email.
  5. Add PagerDuty Services: link to create a PagerDuty service.  When clicked, a browser window will open with the login to the PagerDuty web site, allowing the user to enter their credentials and configure the required PagerDuty service.
  6. Send notifications to: choose from the pull-down list of Webhook-enabled web services that should receive the alert notification.
  7. Edit webhooks: link to create a new webhook in order to add it to the Send Notifications to field.