Notifications

OpsTrails sends notifications when operational guardrails are violated. Configure notification channels to alert the right people through email, webhooks, or incident management platforms.

When Notifications Fire

Notifications are triggered by two types of guardrail violations:

• Change Freeze Violations — An event is recorded during an active change freeze window. The first matching event triggers the notification and marks the freeze as violated.
• Deployment Policy Violations — An event breaks a rule defined in a deployment policy, such as deploying on a blocked day or exceeding a daily cap.

Notification Channels

OpsTrails supports the following notification channels:

• Email — Always enabled. Sent to all organization owners and admins.
• Webhook — Send JSON payloads to any HTTPS endpoint with optional HMAC signing.
• PagerDuty — Create incidents in PagerDuty via the Events API v2.
• Opsgenie — Create alerts in Opsgenie with P3 priority.
• Google Chat — Post messages to a Google Chat space via incoming webhook.

Managing Channels

Notification channels are managed from the OpsTrails console at Settings → Notification Channels.

• Create — Click “Add Channel” and select the channel type
• Verify — Send a test notification to confirm the channel is working
• Enable / Disable — Toggle channels on or off without deleting them
• Delete — Remove a channel and unlink it from all guardrails

Channel Linking

Channels are linked to specific guardrails — each change freeze window and deployment policy can specify which notification channels should fire when a violation occurs. A single channel can be linked to multiple guardrails, and a single guardrail can notify multiple channels.