Uptime alerts in Discord
A message in the channel when a monitor goes down, when it turns slow, and when it is back. Works for a website, an API, a game server port, or a bot's heartbeat.
StatOSSAPP02:51
Northwind: API is down
API (https://api.northwind.example/health) is failing.
Error: timeout, 2 checks in a row, confirmed from a second location.
northwind.statoss.com
Setting it up
- In Discord, open the channel's settings, Integrations, Webhooks, and make a new webhook. Copy its URL.
- In StatOSS, open the page's settings, Alerts, choose Discord under "Add a destination", paste the URL and save.
- Press "Send a test alert" to see the message land.
Discord is on Hobby ($4 a month) and Pro. Email alerts are on every plan, Free included. The pricing page has the rest.
Communities often run more than a website: a game server port, a bot that pings a heartbeat every few minutes, a voice server to ping. Each is a monitor on the same page, and the public page is the place to send members who ask whether it is down for everyone.
What the message says
The page and monitor names, the URL, the reason, the time, and on recovery how long the outage lasted, with a link to the public page.
When an alert goes out
One alert per change of state: when a monitor goes down, when it turns slow, and when it is back, with the time, the reason, and how long it was out. A monitor counts as down after two failed checks in a row, each confirmed by a second server on another network; a single failed check sends nothing. A repeat interval sends a "still down" notice every so many minutes while an outage lasts, and nothing is sent during a maintenance window. Every kind of monitor alerts the same way: a website, an API, a port, a certificate, a cron job.