Configure Slack for Alerting
Use the Grafana Alerting - Slack integration to send Slack notifications when your alerts are firing.
There are two ways of integrating Slack into Grafana Alerting.
Use a Slack API token
Enable your app to access the Slack API. If, for example, you are interested in more granular control over permissions, or your project is expected to regularly scale, resulting in new channels being created, this is the best option.
Use a Webhook URL
Webhooks is the simpler way to post messages into Slack. Slack automatically creates a bot user with all the necessary permissions to post messages to one particular channel of your choice.
Note
Grafana Alerting only allows one Slack channel per contact point.
Before you begin
Slack API Token
If you are using a Slack API Token, complete the following steps.
- Follow steps 1 and 2 of the Slack API Quickstart.
- Add the chat:write.public scope to give your app the ability to post in all public channels without joining.
- In OAuth Tokens for Your Workspace, copy the Bot User OAuth Token.
- Open your Slack workplace.
- Right click the channel you want to receive notifications in.
- Click View channel details.
- Scroll down and copy the Channel ID.
Note
While going through these steps, Slack may prompt you to Reinstall your app in order for the changes to take effect.
Webhook URL
If you are using a Webhook URL, follow steps 1 and 5 in the Slack API Quickstart.
Note
Make sure you copy the Slack app Webhook URL. You will need this when setting up your contact point integration in Grafana Alerting.
Procedure
To create your Slack integration in Grafana Alerting, complete the following steps.
- Navigate to Alerts & IRM -> Alerting -> Contact points.
- Click + Add contact point.
- Enter a contact point name.
- From the Integration list, select Slack.
- If you are using a Slack API token:
- In the Recipient field, copy in the channel ID.
- In the Token field, copy in the Bot User OAuth Token that starts with “xoxb-”.
- If you are using a Webhook URL, in the Webhook field, copy in your Slack app Webhook URL.
- Click Test to check that your integration works.
- Click Save contact point.
Next steps
To add the contact point and integration you created to your default notification policy, complete the following steps.
- Navigate to Alerts & IRM -> Alerting -> Notification policies.
- In the Default policy, click the ellipsis icon (…) and then Edit.
- Change the default policy to the contact point you created.
- Click Update default policy.
Note: If you have more than one contact point, add a new notification policy rather than edit the default one, so you can route specific alerts to Slack. For more information, refer to Notification policies.
Was this page helpful?
Related resources from Grafana Labs
![Getting started with the Grafana LGTM Stack](/static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=200 200w, /static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=400 400w)
![Intro to Kubernetes monitoring in Grafana Cloud](/media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=200 200w, /media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=400 400w)
![Building advanced Grafana dashboards](/media/webinar/AMER_buildadv_notxt.png?w=200 200w, /media/webinar/AMER_buildadv_notxt.png?w=400 400w)