Creating an alert policy

An alert policy allows you to configure a degradation threshold for your metrics. If the metric exceeds the threshold in an undesired direction, you are alerted by your configured notification channel. To create an alert policy, do the following:

1. Start by creating a new metric or navigating to the metric for which you want to be alerted of a change. Learn more about creating a metric.
2. Once you select the metric to create an alert policy for, click the Alert policy tab by the Metric definition tab and fill in the fields as follows:
   
   

   Note: Alert policies can only be created for metrics that are measured per traffic type, rather than those that are measured across the traffic type you are using.

   

   • In the Name field, give your alert policy a human recognizable name. We recommend also including the metric name your alert policy is associated with in your policy name.

   • In the Description (optional) field, optionally give your alert policy a description. This can include anything that would be useful to you and your team if an alert is fired. Include runbooks, alerting protocols, and key information about the alert.

   • 1st alert condition area An alert policy can have multiple alert conditions. Each alert condition relates to a particular environment. Fill in the fields as follows:

   Note: You are limited to one alert policy per environment.

   • • In the Choose your environment field, select the environment you want to apply the alert condition to. If you already have an alert condition for a particular environment, this is not available in the environment menu list when you create a second alert condition.

     • In the Set alert threshold field, add a degradation threshold in the form of a relative percentage threshold or absolute value threshold. The degradation direction is assumed to be the opposite of the desired direction of the metric. Learn more about setting degradation thresholds in the Choosing your degradation threshold for alerting guide.

     • In the Define alert notification channel field, configure who to notify if an alert is fired. As default, the metric owner is selected. You can also select the emails of any group as well as add emails via the freeform section.

3. From here, you can add additional alert conditions.
4. After you finish entering your conditions, click the Create alert policy button. You now have a new alert policy.

When an alert is triggered

When an alert is triggered for a metric, the people you've selected in this section receive an email with the following format:

Subject: "Split Alert Fired: Feature Flag Name has caused Metric Name to degrade by X%" |
Body: "Split has detected a degradation of X% on your Metric Name Metric. Here are the details:

• Feature flag: (name and link to feature flag)
• Alert Policy: (name and link to Alert Policy)
• Metric: (name and link to Metric)
• Baseline Value:
• Treatment Value:
• Impact %:
• Threshold %:
  Please either Kill the feature flag or dismiss this alert in the Split user interface.

-The Split Team

You are receiving this email because you were set as one of the people to be notified on this Alert Policy: (name and link to Alert Policy). If you don't want to receive these emails, please remove yourself from the list of people to be notified on the Alert policy page.""

Learn more about managing alert policies.