docs/alert channels

alert channels

configure where pingguard sends alerts when a monitor misses a ping.

email alertsall plans

email alerts are enabled by default on every account. when a monitor misses a ping, an alert is sent to the email address you used to register.

alerts include the monitor name, the expected ping time, and a direct link to your dashboard.

you can enable or disable email alerts per monitor from the monitor settings page.

slack integrationpro

send alerts directly to a slack channel using an incoming webhook.

how to set up a slack webhook

1. go to api.slack.com/apps and create a new app (or use an existing one).
2. under features, click incoming webhooks and enable it.
3. click add new webhook to workspace and select the channel.
4. copy the webhook url (starts with https://hooks.slack.com/services/...).
5. paste it in your pingguard account settings under alert channels → slack.

once configured, all monitors will send missed-ping alerts to that channel. you can override the channel at the monitor level.

discord integrationpro

send alerts to a discord channel using a discord webhook.

how to set up a discord webhook

1. open discord and go to the channel you want to use.
2. click the gear icon next to the channel name (edit channel).
3. go to integrations → webhooks → new webhook.
4. give it a name (e.g. pingguard) and click copy webhook url.
5. paste it in your pingguard account settings under alert channels → discord.

custom webhookspro

send alerts to any http endpoint. pingguard will POST a json payload when a monitor misses a ping.

payload format

json

{
  "event": "missed_ping",
  "monitor": {
    "id": "monitor_abc123",
    "name": "daily-backup",
    "slug": "daily-backup-x7f2k",
    "interval_seconds": 3600,
    "grace_seconds": 300
  },
  "expected_at": "2024-01-15T14:00:00Z",
  "alerted_at": "2024-01-15T14:05:10Z"
}

recovery event

when a ping arrives after a missed-ping alert, pingguard sends a recovery event:

json

{
  "event": "recovered",
  "monitor": {
    "id": "monitor_abc123",
    "name": "daily-backup",
    "slug": "daily-backup-x7f2k"
  },
  "recovered_at": "2024-01-15T15:01:22Z"
}

your endpoint must respond with a 2xx status code. pingguard will retry failed deliveries up to 3 times with exponential backoff.

← getting started next: api reference →