This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentation Grafana documentation Alerting Configure notifications Configure contact points Grafana IRM

Configure Grafana IRM for Alerting

In Grafana OSS and Grafana Enterprise, you can use a webhook contact point to send alerts to Grafana IRM. Grafana IRM can then route alerts based on escalation chains for your team’s workflows.

The alert notification flow is as follows:

^* Grafana OSS/Enterprise (send webhook alerts)->Grafana Cloud IRM (route via escalation chains)

Configure an integration in Grafana IRM

First, enable an integration in IRM to accept alerts from Grafana Alerting. You can either create a new integration or use an existing Alertmanager or Webhook integration in IRM.

To create the integration, follow the same steps as described in Configure an OnCall integration in IRM:

1. Navigate to Alerts & IRM -> IRM -> Integrations.

2. Click + New integration.

3. Select either Alertmanager or Webhook integration from the list.

   • Alertmanager integration – Includes preconfigured IRM templates for processing Grafana and Prometheus alerts.

     The Grafana Alerting integration works similarly but may display a warning in the UI.

   • Webhook integration – Uses default IRM templates for general alert processing.

4. Provide a title, description, and assign it to a team, then click Create Integration.

5. On the integration details page, copy the HTTP Endpoint URL to use in the next section.

Configure a webhook contact point in Grafana Alerting

Next, configure the contact point in Grafana Alerting to send alert notifications to Grafana IRM.

In Grafana OSS and Grafana Enterprise, you need to create a Webhook contact point using the HTTP endpoint URL you copied in the previous step.

1. Navigate to Alerts & IRM -> Alerting -> Contact points.
2. Click + Add contact point.
3. Enter a name for the contact point.
4. From the Integration list, select Webhook.
5. In the URL field, enter the HTTP endpoint URL of the IRM integration.
6. Click Save contact point.

After configuring the contact point in Grafana Alerting and the integration in Grafana IRM, you can start testing the Alerting-to-IRM integration.

For more information, see:

• Configure contact points – Learn how to test the integration and enable notifications in Alerting.
• Webhook contact point – Learn the format of the webhook payload and additional settings in Alerting.
• Configure IRM alert templates – Learn how to process the incoming webhook messages in IRM.