Notification Policies
Notification policies define which alarm transitions trigger notifications on which channels. Each policy combines a channel, a minimum severity threshold, and a set of transition types (opened, bumped, acknowledged, resolved). Optionally, policies can be scoped to specific alarm rule names. Policy matching happens at enqueue time, so later policy changes do not affect already-queued notifications.
Fields & columns
| Name | Description |
|---|---|
Name | Human-readable policy identifier |
Channel | Which notification channel to use for delivery |
Min Severity | Minimum alarm severity to trigger this policy (info, warning, high, critical) |
Transitions | Which alarm state transitions trigger notifications |
Enabled | Whether this policy is active |
How to
Create a policy for critical alarms
- Click "Add Policy"
- Enter a descriptive name (e.g., "Critical to Slack")
- Select the target channel
- Set minimum severity to "critical"
- Select transitions: opened, resolved
- Click "Create"
Scope a policy to specific alarm rules
- Create or edit a policy
- In the alarm rule names field, enter specific rule names (e.g., scanner-down, db-down)
- Only alarms from those rules will trigger this policy
- Leave empty to match all alarm rules
Gotchas
- Policies are evaluated at enqueue time. Disabling a policy after an alarm fires does not cancel queued notifications.
- A single alarm transition can match multiple policies, sending to multiple channels.
- Severity threshold uses >= comparison: a "warning" threshold matches warning, high, and critical.
- Deleting a channel cascades to delete all its policies.
API calls (5)
| Method | Path | Description |
|---|---|---|
| GET | /api/admin/alerting/notification-policies | List all notification policies |
| POST | /api/admin/alerting/notification-policies | Create a new policy |
| GET | /api/admin/alerting/notification-policies/:id | Get policy details |
| PATCH | /api/admin/alerting/notification-policies/:id | Update a policy |
| DELETE | /api/admin/alerting/notification-policies/:id | Delete a policy |
Related
- Notification Channels — Channels are the delivery targets referenced by policies
- Notification Log — Log shows which notifications were sent for each policy
- Alarm Rules — Policies can be scoped to specific alarm rule names
- Alarms — Alarm state transitions are what policies evaluate to trigger notifications