Skip to main content
Alert rules replace alert routes. This page covers what changes for your organization during the move. To learn how rules work, see alert rules.

How are alert rules different?

Rules belong to teams, not routes

With alert routes, your organization has one list of routes, and each alert is checked against all of them. With alert rules, there are three kinds of rules:
  • Team rules: each team sets rules for its own alerts.
  • Required rules: your organization sets rules that run for every alert, such as posting every critical alert to a shared channel.
  • Default rules: your organization sets rules for alerts with no team, or whose team has no rules yet.
An alert’s team comes from its team attribute. Grouping is set per team too, and teams without their own use the organization’s default grouping. Inside each set of rules, you build blocks of conditions and actions instead of filling in a route’s sections. See coming from alert routes for where each part of a route goes.

You can test your alert rules

This is a new feature which alert routes didn’t support: you can select alerts that you want to simulate your alert routing behaviour for. On All rules, select Test rules and pick some recent alerts. You’ll see which branches each alert matched and every action your rules would take. Nothing is paged, posted or created.

One incident per alert

With alert routes, an alert that matched more than one route could create an incident from each of them. With alert rules, an alert, or its group, creates at most one incident. When more than one set of rules creates an incident for the same alert, required rules win over team rules, and team rules win over default rules. The incident uses the winning rule’s template. The same applies to pages and posts. If two blocks escalate to the same escalation path or post to the same channel, it only happens once.

I’ve got early access, what does this mean?

During early access, your organization is in one of two modes.

Shadowing

Alert routes and alert rules both run for every alert. Your alert routes still decide what happens: who gets paged, where alerts are posted, and which incidents start. Your alert rules run at the same time, but they don’t page anyone, post anything, or create incidents. You can keep editing your alert routes as normal. We convert your changes to alert rules automatically, so your rules stay in step with your routes.

Alert rules only

Alert rules decide everything that happens to an alert. You no longer have access to alert routes, so you make all your changes under On-call → Alert routing → Rules.