Grafana Integration

In ilert: Create a Grafana alert source

1. Go to Alert sources --> Alert sources and click on Create new alert source

   
2. Search for Grafana in the search field, click on the Grafana tile and click on Next.

   
3. Give your alert source a name, optionally assign teams and click Next.

4. Select an escalation policy by creating a new one or assigning an existing one.

   
5. Select you Alert grouping preference and click Continue setup. You may click Do not group alerts for now and change it later.

   
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on Finish setup for now.

7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   

In Grafana: Add ilert Webhook as Alerting Channel

1. In the sidebar, go to Alerting → Notification channels and click on the New channel button.

1. Select Type webhook and in the field URL insert the webhookurl generated in ilert. Set the HTTP Method to POST.

1. Optionally test the integration by cliking on the Send Test button. Click on Save

1. Check if an alert has been created in ilert.

2. After the Notification Channel has been created in Grafana, add it to one or more graph alerts.

3. Switch to any dashboard of your Grafana installation and edit a graph.

1. In the edit view, open the Alert section via the left sidemenu and click on the green Create Alert button.

2. Fill in the desired condition and select the relevant ilert Notification channel under Notifications → Send to you created in steps 2 and 3. Do not forget to save the dashboard afterwards (in the upper right Navibar).

1. The integration is now set up!

FAQ

Will alerts in ilert be resolved automatically?

Yes, as soon as an alert with "ok" has been resolved in Grafana, the associated alert in ilert will be resolved automatically.

What happens when an alert is paused in Grafana, is the associated alert also accepted in ilert?

Yes.

Can I link Grafana to multiple alert sources in ilert?

Yes, create a Notification Channel per alert source in Grafana.