Skip to main content
Use pgDash webhook notifications to send PostgreSQL monitoring alerts to Flashduty On-call. Each pgDash server maps to one Flashduty alert: it triggers or updates when alert rules fire on the server, and recovers automatically when all of its alerts clear.

In Flashduty On-call

You can get the integration push URL in either of the following ways.

Use a dedicated integration

  1. In the Flashduty console, select Channel and open a channel
  2. Select Configuration → Integrations → Private integration, then click Add integration
  3. Select pgDash and click Save
  4. Open the generated integration card and copy the Push URL

Use a shared integration

  1. In the Flashduty console, go to Integration Center → Alert Events
  2. Select pgDash and enter an integration name
  3. Configure the default route and select a channel. You can add more rules under Routing after creation
  4. 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 SettingsClick 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.
Enter this push URL only on the Alerts page. Notifications from the Change Alerts page carry no alert state; when they reach this integration, Flashduty returns success and creates no alert.

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 (the alerts 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 alerts array recovers the alert
When a single alert item clears while the server still has other alerts, pgDash sends no separate recovery for that item. The Flashduty alert stays triggered and its description lists only the items still firing. Flashduty rejects requests that lack the server or alerts field.
Renaming a server in pgDash produces a new Alert Key. Close alerts under the old name manually.

Status and severity

Alert content

  • Title: server name: rule description, taken from the first crit item (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 (always pgdash)

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
For field details, see pgDash Webhooks.