Slack
Post project events and monitoring alerts to a Slack channel, through an incoming webhook.
You need an incoming webhook URL for the channel, from a Slack app in your workspace. It looks like https://hooks.slack.com/services/.... One URL can serve project events and alerts both.
Project events
Send spec uploads, docs publishes, SDK builds and the project's other events to Slack.
- Open the webhooks
Open Integrations in the project sidebar, choose Slack under Notifications and paging, then Add a webhook (Manage webhooks once the project has one).
- Add a Slack webhook
Press New webhook, choose Slack, and paste the incoming webhook URL.
- Pick the events
Forward only what you need, or use Select all. Then press Send test to check a message arrives.
Each message is one line with the project's name in bold and what happened. For every event and the delivery log, see webhooks.
Monitoring alerts
Send error spikes, new issues and regressions from your API's monitoring to Slack.
- Open the alert rules
Open Monitoring, then the Alerts tab, and create a rule or edit one. The Slack card on the Integrations page links there too, and lists the rules already using it.
- Choose Slack as the channel
Pick Slack and paste the incoming webhook URL, which must be on
hooks.slack.com. The message names the rule and its kind, and for a threshold, the value against its limit. Alert channel addresses must be publichttps://URLs: Octri refuses a private or internal address.
Each rule has one channel. To reach several places, make a rule for each. See alerts for the rule kinds, windows and cooldowns.