Help / Alerts
Slack
A Slack channel posts alerts into a channel in your Slack workspace, so the whole team sees them in one place. It uses a Slack incoming webhook: a private web address that lets HonkWatch post to that one channel.
What you need first
- A Slack workspace where you are allowed to add apps. In some workspaces an admin has to approve new apps.
- The Slack channel the alerts should go to.
Make an incoming webhook in Slack
Slack changes its screens from time to time. If these steps do not match what you see, follow Slack's own guide, Sending messages using incoming webhooks.
- Go to api.slack.com/apps and sign in to your workspace.
- Create a new app from scratch. Give it a name such as "Uptime alerts" and pick your workspace.
- In the app's settings, open Incoming Webhooks and turn them on.
- Add a new webhook to the workspace and choose the channel for alerts.
- Copy the webhook URL. It starts with
https://hooks.slack.com/services/.
Treat the webhook URL like a password. Anyone who has it can post into that channel.
Add it in HonkWatch
- Open Alerts and go to Add a channel.
- Under Where should alerts go?, choose Slack.
- Paste the webhook URL into Send to.
- If you like, type the Slack channel name in Label (optional), so you can tell channels apart later.
- Tick the events to post: Down, Back up, Certificate expiring and Slow.
- Press Add channel.
Send a test
- In the channel list on Alerts, press Send test on the Slack row.
- A message about "Test monitor" should appear in the Slack channel shortly.
What an alert looks like
Each alert is a plain text message. The first line is the service name in square brackets, then the monitor and what happened, for example "Shop is DOWN". Below it are the monitor's address, the reason and a link to the monitor's page.
If it does not work
- You see "That needs an https:// address". Paste the whole webhook URL, starting with
https://. - Recently sent shows failed. Slack refused the message. This usually means the webhook was removed, the app was uninstalled or the channel was archived or deleted. Make a new webhook in Slack, add it as a new channel here, test it, then remove the old channel.
- Recently sent shows sent, but you see nothing. Check you are looking at the channel you picked when you made the webhook. The webhook always posts to that channel.
- You want alerts in a different Slack channel. Make a new webhook for that channel in Slack and add it as a new channel here.
See also Setting up alerts for which events go where.
Still stuck? Email [email protected] and say which guide you were following.