Notifications: Opsgenie

Page oncall via Atlassian Opsgenie.

The Opsgenie integration follows the same pattern as PagerDuty — critical events only.

1. Get an integration API key

In Opsgenie:

Settings → Integrations → Add Integration → API.
Configure restrictions (recommended: limit to grith-specific actions).
Copy the API key.

2. Configure

[notifications.channels.opsgenie]
enabled = true
api_key = "..."
region = "us"                          # "us" | "eu"
team = "security-oncall"               # routing key
events = ["canary", "capability_deny"]
severity_map = { canary = "P1", capability_deny = "P3" }
dedupe_window_seconds = 300

3. Test

grith notifications test opsgenie

An alert appears in the Opsgenie team queue.

Severity mapping

Opsgenie uses P1–P5. Suggested mapping:

grith event	Opsgenie priority
`canary`	P1 (urgent)
`capability_deny`	P3 (default)
`queue` (Pro escalations only)	P4 (low)

Auto-close