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

  1. Click "Add Policy"
  2. Enter a descriptive name (e.g., "Critical to Slack")
  3. Select the target channel
  4. Set minimum severity to "critical"
  5. Select transitions: opened, resolved
  6. Click "Create"

Scope a policy to specific alarm rules

  1. Create or edit a policy
  2. In the alarm rule names field, enter specific rule names (e.g., scanner-down, db-config-down)
  3. Only alarms from those rules will trigger this policy
  4. Leave empty to match all alarm rules

Gotchas

  1. Policies are evaluated at enqueue time. Disabling a policy after an alarm fires does not cancel queued notifications.
  2. A single alarm transition can match multiple policies, sending to multiple channels.
  3. Severity threshold uses >= comparison: a "warning" threshold matches warning, high, and critical.
  4. 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 Pages

  • 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