Notification Rules
Configure notification routing rules to control which alert events go to which channels based on severity and event type.
Notification rules control the routing of alert events to channels. Each rule specifies which events and severity levels it matches, and optionally overrides the destination channel. Use notification rules to send critical alerts to PagerDuty, moderate alerts to Slack, and resolved notifications to a low-priority channel.
How routing works
When an alert event occurs (created, escalated, acknowledged, resolved), Planekeeper evaluates all active notification rules for the organization in priority order:
- Check the rule’s severity filter against the alert’s severity.
- Check the rule’s event filter against the event type.
- If both match, create a delivery record for the rule’s channel (or the default channel if no override is set).
- Deduplicate: if multiple rules route the same event to the same channel, only one delivery is created.
Event types
| Event | When it fires |
|---|---|
alert.created | A new alert is generated for the first time |
alert.escalated | An existing alert’s severity increased (e.g., high to critical) |
alert.acknowledged | Someone acknowledged an active alert |
alert.unacknowledged | An acknowledgment was reset (version changed while acknowledged) |
alert.resolved | The alert was automatically resolved because the gap dropped below thresholds |
Severity filtering
Each rule can filter by one or more severity levels: moderate, high, critical. Leave the filter empty to match all severities.
Examples:
| Severity filter | Matches |
|---|---|
| (empty) | All alerts regardless of severity |
critical | Only critical alerts |
high, critical | High and critical alerts |
moderate | Only moderate alerts |
Create a notification rule
Navigate to Notification Rules in the sidebar.
Click Create Rule.
Fill in the form:
Field Description Name A descriptive label, e.g., “Critical to PagerDuty” Event filter Select which event types this rule matches (leave empty for all) Severity filter Select which severity levels this rule matches (leave empty for all) Channel Optional. Override the destination channel. Leave blank to use the organization’s default channel Priority Higher numbers are evaluated first Click Save.
Priority and ordering
Rules are evaluated from highest priority to lowest. Every matching rule produces a delivery, so multiple rules can match the same event. Planekeeper deduplicates deliveries to the same channel – an alert event is delivered to each channel at most once, even if multiple rules route to it.
Example priority setup:
| Priority | Rule | Channel |
|---|---|---|
| 100 | Critical alerts | PagerDuty |
| 50 | All alerts | Slack |
| 10 | Resolved events | Archive webhook |
In this setup, a critical alert would be delivered to both PagerDuty (priority 100 match) and Slack (priority 50 match). A moderate alert would only go to Slack. A resolved event would go to both Slack and the archive webhook.
Channel override vs. default
Each rule can either specify a channel or rely on the organization’s default channel.
- With channel override: Deliveries go to the specified channel regardless of the default.
- Without channel override: Deliveries go to whichever channel is set as the organization default.
Toggle a rule on or off
Each notification rule has an active/inactive toggle. Click the toggle badge on the rules list to switch the state.
- Active rules participate in routing decisions.
- Inactive rules are skipped entirely. Events that would have matched are not routed through them.
Common routing patterns
Escalation-based routing
Route different severities to different channels:
- Rule 1 (priority 100): severity =
critical, channel = PagerDuty - Rule 2 (priority 50): severity =
high, critical, channel = Ops Slack - Rule 3 (priority 10): severity = (all), channel = General Slack
Critical alerts reach all three channels. High alerts reach Ops Slack and General Slack. Moderate alerts reach only General Slack.
Event-type routing
Route specific lifecycle events to dedicated channels:
- Rule 1: event =
alert.created, alert.escalated, channel = Ops Slack - Rule 2: event =
alert.resolved, channel = Changelog webhook - Rule 3: event =
alert.acknowledged, channel = Audit log webhook
Catch-all rule
Create a single low-priority rule with no filters to ensure every event reaches at least one channel:
- Rule: priority = 1, severity = (all), event = (all), channel = (default)
This acts as a safety net for any events not caught by more specific rules.
Bulk delete
Select multiple notification rules using the checkboxes on the list page, then click Delete Selected to remove them in a single operation. Use the checkbox in the table header to select all visible items.
Delete a notification rule
- Navigate to Notification Rules.
- Click the rule you want to remove.
- Click Delete.
Deleting a rule takes effect immediately. Future events that would have matched will no longer be routed through it.