Creating and Editing Alert Rules

This article describes the steps for adding or editing an alert rule. To understand how alerts work, see How Alerts Work.

To create a new alert rule, click Alerts > Alert Rules. The Alert Rules page opens.

Select the desired source from the tabs at the top:

  • Cloud and Enterprise Agents

  • Endpoint Agents

  • BGP Routing

  • Devices

Then click Add New Alert Rule. The Add New Alert Rule panel appears, displaying the Settings tab.

  1. Alert Type Layer: test layers available to your organization.

  2. Alert Type: available alert types for the selected test layer.

  3. Rule Name: the name of the alert rule.

Settings Tab

Use the Settings tab to configure the conditions on which an alert rule is triggered, and assign the alert rule to tests and agents. Settings vary with the source tab selected. The above image displays the Cloud and Enterprise Agents tab.

  1. 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 rule.

  2. Agents: Select the agents to which you will assign this alert rule. The options are:

  3. All agents: All agents will be assigned this alert rule

  4. All agents except: All agents will be assigned this alert rule except for the ones selected

  5. Specific agents: Only the selected agents will receive this alert rule

  6. Specify the number of agents, any number of the following alerting conditions, and the number of test rounds during which 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 rule. For a list of alerting conditions, see here.

  8. Compatible Test Types: lists the test types to which this alert rule can be assigned.

  9. Notifications: tab to display settings for receiving alert notifications. See listing and graphic below.

Notifications Tab

Use the Notifications tab to configure the methods by which users are notified when an alert rule is triggered.

  1. Send emails to: email addresses that receive the alert notification.

  2. Edit emails: create or edit an email address which can then be added to the Send emails to field.

  3. Send an email when alert clears: if checked, an email is sent when the alert rule is no longer triggered.

  4. Add message: an optional field for text that will be sent in the body of the alert email. Note that greater than ">" and less than "<" characters are not allowed in this field.

  5. Webhooks: Webhooks-enabled web services that receive the alert notification.

  6. Edit webhooks: create or edit webhooks that can then be added to the Webhooks Send Notifications to field.

  7. Integrations: integrations that should receive the alert notification.

  8. Edit Integrations: create or edit an integration that can then be added to the Integrations Send Notifications to field. Currently, ThousandEyes offers integrations for PagerDuty, Slack and ServiceNow.