zulip/zerver/webhooks/grafana/doc.md

See your Grafana dashboard alerts in Zulip!

1. {!create-stream.md!}

2. {!create-an-incoming-webhook.md!}

3. {!generate-integration-url.md!}

Instructions for Grafana 8.3 and above

1. In Grafana, go to Alerting. Click on Contact points, and then Add contact point. Configure the new contact point as follows: set the name; under Integration choose Webhook, and set URL to the URL constructed above; under Optional Webhook settings choose POST as the HTTP method. Click on Test to send a test notification and if all is good, click on Save contact point.
2. Under Notification policies create a new policy (for example, a New nested policy of the Default policy), setting the Matching label as Zulip = 1, and selecting the Contact point as the one created in the step above. Click on Save policy.
3. Under Alert rules, click on Create alert rule, where you will specify the conditions to fire the alert. Make sure you set the Rule name, and in the Notifications section add a label that matches the label created in the step above. Customize the query and alert condition, alert evaluation behavior, etc. and click on Save rule.

Instructions for Grafana 8.2 and below

1. In Grafana, go to Alerting. Click on Notification channels. Configure Edit Notification Channel as appropriate for your alert notification. Set the name. Under Type, choose webhook. In Webhook Settings, set URL to the URL constructed above. Under HTTP method, choose POST. Click Save.

2. Create an alert. Within your new alert rule, scroll down to the Notifications section. Click on the button next to Send to and select the webhook notification channel you just made. You can also choose to write a message, which will be included in the Zulip notifications.

3. Return to Notification channels. You may now click Send Test and you will see a Grafana test alert notification in Zulip.

{!congrats.md!}