sentinel

Discord integration

Receive alerts in Discord when a monitor is overdue.

How it works

The integration will only be triggered when a backup is overdue/ failed or has recovered.

Alerts arrive as an embed, coloured by state, with the facts in labelled fields:

🔴 db-production is OVERDUE — no successful backup before the deadline.

   Last backup   2026-07-14 03:00:12 +0000
   Expected      At 03:00 AM Europe/Sofia (+1h grace)
   Monitor       View monitor

🟢 db-production is OK — backup ran after 1 day 1 hour of silence. 

1. Create a webhook in Discord

In Discord, open Server Settings → Integrations → Webhooks, click New Webhook, pick the channel the alerts should land in, then click Copy Webhook URL. You need the Manage Webhooks permission on the server. The URL looks like this:

https://discord.com/api/webhooks/000000000000000000/XXXXXXXXXXXXXXXX

Treat it as a secret: anyone holding it can post to that channel. If it leaks, delete the webhook in Discord and add a new integration here.

2. Add it to the monitor

Open your monitor and click on the Integrations tab. Find Discord in the list and click configure.

Give it a descriptive name in the Label field and paste the URL from step 1 in the Webhook URL field. Click on the add webhook button to save the integration.

3. Send a test

Make sure the webhook works by clicking the test button. A test alert should appear in the channel straight away; if Discord rejects it, the reason is shown under the button.

Further reading