Add Routing Labels to Alerts

Routers use routing labels to determine which alerts should be processed through them. By configuring routing labels on an alert, Notification Center automatically applies the routing logic based on these labels.

What routing labels do

Routing labels are key–value pairs that connect alerts to routers.

When a notification request includes routing labels that match those defined on a router:

• The router’s rules are evaluated and applied.
• If routing labels are missing or do not match, the router does not process the alert.

Matching examples

Label format

Routing labels are added to alerts with a routing prefix:

routing.<key>: <value>

Add labels to an alert

1. Navigate to Alerts, then select Create Alert or edit an existing alert.
2. In the Notifications section under Notification Center, add one or more routing labels.
3. The Matching routers list updates automatically to show routers matched by the labels you add.
4. Save the alert.
5. When triggered, the alert automatically routes through all routers matching its routing labels.

Label requirements

• Labels are case-sensitive.
• Duplicate keys are not allowed.
• Use consistent label names across alerts to prevent routing mismatches.

Next steps

• Routers: Create routers that match your routing labels (team, environment, service)
• Routing Rules: Add conditions that send matching alerts to the right destinations