In Flashduty On-call
You can get the integration push URL in either of the following ways.Use a dedicated integration
- In the Flashduty console, select Channel and open a channel
- Select Configuration → Integrations → Private integration, then click Add integration
- Select pgDash and click Save
- Open the generated integration card and copy the Push URL
Use a shared integration
- In the Flashduty console, go to Integration Center → Alert Events
- Select pgDash and enter an integration name
- Configure the default route and select a channel. You can add more rules under Routing after creation
- Click Save and copy the generated Push URL
Configure pgDash
1
Set alert rules in pgDash
Where: pgDash › Server › AlertsThe setup is the same for pgDash SaaS and self-hosted pgDash. Webhooks require pgDash 2.4.11 or later.
Alert rules are evaluated each time pgDash receives a pgmetrics report for the server.
2
Enter the webhook URL in pgDash
Where: pgDash › the server › Alerts › Notification Settings
Click Update to save.Webhooks are set per server. To connect more servers, repeat this step for each server. They can share the same push URL. pgDash webhooks have no separate recovery setting: when all alerts on the server clear, pgDash automatically sends one notification with an empty
alerts array, and Flashduty recovers the alert from it.3
Trigger an alert in pgDash and confirm
Where: pgDash › the server › AlertspgDash’s own documentation mentions no test-delivery entry for webhooks. Let a rule genuinely fire (for example, temporarily lower its threshold) and wait for pgDash to receive the server’s next pgmetrics report. Then go back to Flashduty: the integration shows a Latest event time and an alert for the server appears. Restore the threshold, and once all alerts clear, confirm the alert recovers.
Alert lifecycle
pgDash webhooks are edge-triggered: a notification is sent only when the alert status of a server changes, and each notification carries every current alert item of that server (thealerts array). When all alerts clear, pgDash sends one notification with an empty alerts array.
Flashduty therefore computes the Alert Key from the server name server, so every notification for the same server lands on the same alert:
- A notification with alert items triggers or updates the alert. The title and description are replaced with the latest alert items
- A notification with an empty
alertsarray recovers the alert
server or alerts field.
Status and severity
Alert content
- Title:
server name: rule description, taken from the firstcrititem (or the first item if none is critical).(+N more)is appended when there are several items - Description: the pgmetrics report time (UTC) and, for each alert item, its type, rule description, current value, object name, and link. Query-level alerts include the SQL text (truncated to 500 characters). Up to 50 items are listed
- Labels:
server,check(rule description of the item used in the title),resource(that item’s object name),link(that item’s pgDash link),alert_count(number of current alert items),source(alwayspgdash)
Troubleshooting
- pgDash sends nothing: pgDash notifies only when the alert status changes and does not repeat an unchanged state. Check that an alert rule has fired and that the webhook is set on the Alerts page, not the Change Alerts page
- Delivery times out: pgDash expects a response within 3 seconds and retries at most 3 times on timeout. For self-hosted pgDash, make sure the pgDash server can reach the push URL
- The alert does not recover: it recovers only when all alerts of the server clear. While any other item is still firing, the alert stays open