Configure Grafana IRM for Alerting
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow Alertingbreadcrumb arrow Configure notificationsbreadcrumb arrow Configure contact pointsbreadcrumb arrow Grafana IRM
Grafana Cloud

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:

  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 Grafana IRM.
  5. 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.
  6. (Optional) Configure optional settings.
  7. 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.

KeyDescription
HTTP MethodSpecifies the HTTP method to use: POST or PUT.
Basic Authentication UsernameUsername for HTTP Basic Authentication.
Basic Authentication PasswordPassword for HTTP Basic Authentication.
Authentication Header SchemeScheme for the Authorization Request Header. Default is Bearer.
Authentication Header CredentialsCredentials for the Authorization Request header.
Max AlertsMaximum number of alerts to include in a notification. Any alerts exceeding this limit are ignored. 0 means no limit.

Optional payload settings

The IRM contact point sends alert messages to Grafana IRM using the JSON payload format used by the webhook integration:

json 
{
  "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.

OptionDescription
TitleSends the value as a string in the title field of the JSON payload. Supports notification templates.
MessageSends the value as a string in the message field of the JSON payload. Supports 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.

Optional notification settings

KeyDescription
Disable resolved messageEnable this option to prevent notifications when an alert resolves.