Create or Configure a Metric Alert

Learn how to create new metric alerts or configure existing alerts.

Metric alerts allow you to set an expected range for changes in metric values over time.

Example: Let's say your organization sets Headcount to an expected range of -2% to 2%. Any changes to your organization's headcount value that exceeds 2% in any direction will trigger the metric alert when a new data version is generated and cause an issue to be created. If the Headcount alert is critical, any changes exceeding 2% in any direction will fail the data version and require an admin to review the data version.

Create a metric alert

  1. In a project, on the navigation bar, click Validation > Alerts.
  2. Click Create Alert.
  3. In the Alert Creation dialog, select Metric Alert, and then click Next.
  4. Select a metric from the list and click Next.

  5. Type a display name and description.

  6. Click Create.
  7. Configure the alert. For more information, see Configure a metric alert below.

Configure a metric alert

Specify the exact conditions of the alert.

  1. In a project, on the navigation bar, click Validation > Alerts.
  2. Click Metric Alerts and select the alert to configure.
  3. Enable or disable the alert. If enabled, the alert will check every data load job for metric values outside the expected range.
  4. Select a comparison type to use for the alert.
    • Month to Month: Indicates that the new value should be compared to last month's value.
    • DV to DV: Indicates that the new value should be compared to the previous production data version.
    • Value: Indicates that the new value should be compared to a specific value.
  5. Type a value to be the lower bound of the metric's expected range of change.
  6. Type a value to be the upper bound of the metric's expected range of change.
  7. Optional: Type a number for the rolling window period in months. If blank, the rolling window period is disabled. This is the number of historical months to exclude from the alert. For example, if you don't want to validate the past three months for the new data load, type 3 in this field.
  8. If the alert should fail the data version, enable the Critical toggle. If the alert is triggered in data load jobs, the data version will fail and require an admin to review the data version.
  9. When finished, publish your project to production. For instructions, see Publish Project Changes.