Docs / Monitoring & alerts

Send alerts to Slack or Discord

5 minute read

Alerts reach Slack and Discord through an incoming webhook URL that you create in the chat app and paste into SimpliCloud once. Every alert rule can then send to that channel.

1. Create a Slack incoming webhook

In Slack, go to api.slack.com/apps, choose Create New App, From scratch, and pick your workspace. Open Incoming Webhooks, turn them on, choose Add New Webhook to Workspace and pick the channel, for example #ops. Copy the URL.

https://hooks.slack.com/services/T04KORA00/B07OPS000/xxxxxxxxxxxxxxxxxxxxxxxx

2. Or create a Discord webhook

In Discord, open Server Settings, Integrations, Webhooks, New Webhook. Name it SimpliCloud, choose the channel, for example #alerts, and choose Copy Webhook URL.

https://discord.com/api/webhooks/1234567890123456789/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. Add the channel in SimpliCloud

Open Monitoring & alerts and, under Where alerts go, add a channel. Choose Slack or Discord, give it the name people will see (such as Slack · #ops) and paste the URL.

simplicloud alerts channels add slack "#ops" \
  --url https://hooks.slack.com/services/T04KORA00/B07OPS000/xxxxxxxx
simplicloud alerts channels add discord "#alerts" \
  --url https://discord.com/api/webhooks/1234567890123456789/xxxxxxxx

4. Attach it to rules and test

Edit a rule and tick the new channel, or pick it when you create one. Then use Send test. A real alert looks like this:

[Alert] reports-runner
CPU 93% (above 80% over 5 min)
Production · Lagos · 09:31
Open in console → https://console.simplicloud.ai/#monitoring
[Resolved] reports-runner
CPU back to 41%

• •Each rule notifies once when it fires and once when it recovers, not every minute.
• •If Slack or Discord rejects the message, the channel is marked Failing and the owner gets an email.