Notifications

Overview

The notification system delivers timely alerts about infrastructure changes, findings, and events. Users configure their preferred channels, set delivery rules, and subscribe to the events that matter to them.

Notification channels

Event types

Notifications can be configured for any event type:

• Resource events -- creation, update, deletion of resources
• Change events -- critical changes, configuration drift
• Finding events -- new findings, finding resolution
• Discovery events -- discovery completion, failure, or delay
• Policy events -- policy violations, compliance changes
• System events -- certificate expiration, storage thresholds

Delivery rules

Delivery rules control when and how notifications are sent:

• Severity filters -- only deliver notifications above a minimum severity
• Time windows -- suppress notifications during specified hours
• Escalation paths -- if no response in N minutes, escalate to next channel
• Rate limiting -- prevent notification storms with configurable rate limits
• Deduplication -- merge similar notifications into a single alert

User preferences

# Per-user notification preferences
{
  "user_id": "usr_abc123",
  "channels": {
    "email": { "enabled": true, "address": "user@acme.com" },
    "slack": { "enabled": true, "channel": "#infra-alerts" },
    "pagerduty": { "enabled": false }
  },
  "subscriptions": [
    {
      "event_type": "finding.critical",
      "channels": ["email", "slack"],
      "scopes": ["production"]
    },
    {
      "event_type": "discovery.failed",
      "channels": ["pagerduty"],
      "scopes": ["*"]
    }
  ],
  "quiet_hours": {
    "enabled": true,
    "start": "22:00",
    "end": "07:00",
    "timezone": "America/New_York",
    "emergency_override": true
  }
}

Digests

For lower-priority events, users can configure periodic digests:

• Daily digest -- summary of the day's events delivered each morning
• Weekly digest -- weekly summary with trend data
• Scope digest -- per-scope digest for teams managing specific environments
• Custom digest -- user-defined digest with selected event types