Configure Grafana IRM for Alerting
Use the Grafana IRM integration in contact points to send alerts to Grafana IRM. You can then route them based on the escalation chains and schedules defined in Grafana IRM.
Before you begin
Make sure Grafana IRM is activated in your Grafana Cloud instance.
Note that the Grafana IRM contact point is only available when using the built-in Grafana Alertmanager.
To configure Grafana IRM with Grafana OSS or Grafana Enterprise, refer to the Grafana OSS documentation.
Configure Grafana IRM for a contact point
To create a contact point with a Grafana IRM integration, complete the following steps:
- Navigate to Alerts & IRM -> Alerting -> Contact points.
- Click + Add contact point.
- Enter a name for the contact point.
- From the Integration list, select Grafana IRM.
- Choose whether to add a new IRM integration or add an existing one.
- If you add a new one, enter an integration name.
- If you add an existing one, choose from the list of available integrations.
- (Optional) Configure optional settings.
- Click Save contact point.
For more details on contact points, including how to test them and enable notifications, refer to Configure contact points.
Optional settings
The IRM contact point in Grafana Alerting integrates with Grafana IRM using webhook requests. The following settings allow you to customize webhook requests when needed.
Optional payload settings
The IRM contact point sends alert messages to Grafana IRM using the JSON payload format used by the webhook integration:
{
"orgId": 1,
"state": "alerting",
"title": "[FIRING:1] TestAlert Grafana ",
"alerts": [
{
"endsAt": "0001-01-01T00:00:00Z",
"labels": {
"instance": "Grafana",
"alertname": "TestAlert"
},
"status": "firing",
"values": null,
"panelURL": "",
"startsAt": "2025-04-07T14:42:52.388041666Z",
"silenceURL": "https://alerttest.grafana.net/alerting/silence/new?alertmanager=grafana&matcher=alertname%3DTestAlert&matcher=instance%3DGrafana",
"annotations": {
"summary": "Notification test"
},
"fingerprint": "57c6d9296de2ad39",
"valueString": "[ metric='foo' labels={instance=bar} value=10 ]",
"dashboardURL": "",
"generatorURL": ""
}
],
"status": "firing",
"message": "**Firing**\n\nValue: [no value]\nLabels:\n - alertname = TestAlert\n - instance = Grafana\nAnnotations:\n - summary = Notification test\nSilence: https://alerttest.grafana.net/alerting/silence/new?alertmanager=grafana&matcher=alertname%3DTestAlert&matcher=instance%3DGrafana\n",
"version": "1",
"groupKey": "test-57c6d9296de2ad39-1744036972",
"receiver": "test",
"numFiring": 1,
"externalURL": "https://alerttest.grafana.net/",
"groupLabels": {
"instance": "Grafana",
"alertname": "TestAlert"
},
"numResolved": 0,
"commonLabels": {
"instance": "Grafana",
"alertname": "TestAlert"
},
"truncatedAlerts": 0,
"commonAnnotations": {
"summary": "Notification test"
}
}You can also customize some fields in the JSON payload using notification templates.
Note
A Grafana IRM contact point can either create or use a Grafana Alerting integration from your Grafana IRM account.
The Grafana Alerting integration in IRM includes preconfigured templates that automatically process JSON messages sent from Grafana Alerting. For additional details, refer to Configure IRM alert templates.



