PagerDuty plugin
Pages your on-call rotation when a P0 or P1 report lands in Mushi.
Setup
- In PagerDuty, navigate to Services → your service → Integrations and add the Events API v2 integration.
- Copy the Integration Key (looks like
R01AB…). - In Mushi: Marketplace → PagerDuty → Install.
- Paste the integration key into
routing_key. - Set
subscribed_severities— default isp0,p1. Change top0,p1,p2to also page for high-severity reports.
Behaviour
| Event | Action |
|---|---|
report.created where severity ∈ subscribed_severities | Fires a PagerDuty trigger event |
report.status_changed → resolved | Fires a resolve with the same dedup_key, auto-closing the incident |
PagerDuty event fields:
| PagerDuty field | Mushi source |
|---|---|
dedup_key | report_id — prevents double-paging on retries |
summary | report title |
source | report url |
severity | p0/p1 → critical, p2 → error, p3 → warning |
custom_details | { severity, taxonomy_path, blast_radius } |
Troubleshooting
- No page fired — check Marketplace → PagerDuty → Deliveries for the last dispatch status. A
401means the integration key is wrong; a429means PagerDuty rate-limited the request. - Duplicate incidents — confirm
dedup_key = report_idis being used. If you’ve installed two PagerDuty plugins on the same project, deduplicate by removing one. - Incident not auto-resolving — the
report.status_changedevent is only emitted when status is set via the Mushi API or admin console, not when the fix PR is merged (usefix.appliedfor that).
Last updated on