PagerDuty
Open an incident for emergency notifications.
What it does
Opens a PagerDuty incident for each notification that reaches it. This allows Prowl to page your on-call.
Before you start
Choose which PagerDuty service you want to receive the incidents.
Set it up
Choose "Connect with PagerDuty" and pick the service to connect to. PagerDuty creates the integration and returns you to Prowl.
Alternatively, you can add it yourself:
- Open the service and choose its "Integrations" page tab.
- Choose "Add an integration", choose "Events API V2", then "Add".
- Choose the just-added integration's gear button.
- Copy the "Integration Key".
- Paste it into "Routing key"
Prowl checks if it's correct immediately, without opening an incident.
Only Emergency notifications open incidents by default. You can lower the minimum priority on the Destination if you want more.
Check it works
Before you send a notification, make sure whoever will get paged expects it. Send an Emergency priority notification, and an incident will be opened.
Options and behavior
Each notification opens one incident. Priorities carry over: Emergency opens a critical incident, High an error, Normal a warning, and Moderate and Very low an info.
If Prowl retries sending a notification after receiving a transient error, it will not open a second incident by accident.
Prowl does not acknowledge or resolve incidents. For example, a Heartbeat recovery notification is independent. (Want auto-resolve behavior? Contact us so we get a feel for demand.)
Troubleshooting
Incidents don't appear
PagerDuty does not tell Prowl whether an integration still exists, so Prowl can't tell when it stops working. If incidents stop arriving, check in PagerDuty that:
- The integration is still in the service's "Integrations" tab
- The service isn't in maintenance
- No event rule or suppression is dropping Prowl events
Disconnect or replace it
To move to a different service, or after rotating the key, add a second Destination with the new key and then remove the old one. Choose its Sources and minimum priority again.
Remove the Destination to stop opening new incidents. Incidents already opened will not be resolved.