apitech
/
grafana
mirror of https://github.com/grafana/grafana
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
57611 Commits
2179 Branches
608 Tags
1.9 GiB
 
 
 
 
 
 
Tag: Branch: Tree: 646b11a964
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '646b11a964'
${ noResults }
grafana/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-irm.md

155 lines
8.0 KiB
Raw Blame History

---
aliases:
- ../../../configure-notifications/manage-contact-points/integrations/configure-oncall/ # /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/manage-contact-points/integrations/configure-oncall/
- ../../../alerting-rules/manage-contact-points/configure-oncall/ # /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/manage-contact-points/configure-oncall/
- ../../../alerting-rules/manage-contact-points/integrations/configure-oncall/ # /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/manage-contact-points/integrations/configure-oncall/
- ../configure-oncall/ # /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/manage-contact-points/configure-oncall/
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-irm/
description: Configure the Alerting - Grafana IRM integration to connect alerts generated by Grafana Alerting with Grafana IRM
keywords:
- grafana
- alerting
- oncall
- irm
- integration
labels:
products:
- cloud
menuTitle: Grafana IRM
title: Configure Grafana IRM for Alerting
weight: 120
refs:
notification-templates:
- pattern: /docs/grafana/
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/template-notifications/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/
irm:
- pattern: /docs/
destination: /docs/grafana-cloud/alerting-and-irm/irm/
irm-alert-templates:
- pattern: /docs/
destination: /docs/grafana-cloud/alerting-and-irm/irm/configure/escalation-routing/alert-templates/
webhook-json-payload:
- pattern: /docs/grafana/
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/#json-payload
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/#json-payload
configure-contact-points:
- pattern: /docs/grafana/
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/manage-contact-points/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/
---
# Configure Grafana IRM for Alerting
Use the Grafana IRM integration in contact points to send alerts to [Grafana IRM](ref:irm). You can then route them based on the escalation chains and schedules defined in Grafana IRM.
## Before you begin
The Grafana IRM contact point is only available when using the built-in Grafana Alertmanager.
Ensure that Grafana IRM is activated in your Grafana Cloud instance.
## 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**.
1. Click **+ Add contact point**.
1. Enter a name for the contact point.
1. From the **Integration** list, select **Grafana IRM**.
1. 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.
1. (Optional) Configure [optional settings](#webhook-settings).
1. Click **Save contact point**.
For more details on contact points, including how to test them and enable notifications, refer to [Configure contact points](ref: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.
| Key | Description |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| HTTP Method | Specifies the HTTP method to use: `POST` or `PUT`. |
| Basic Authentication Username | Username for HTTP Basic Authentication. |
| Basic Authentication Password | Password for HTTP Basic Authentication. |
| Authentication Header Scheme | Scheme for the `Authorization` Request Header. Default is `Bearer`. |
| Authentication Header Credentials | Credentials for the `Authorization` Request header. |
| Max Alerts | Maximum 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](ref:webhook-json-payload):
```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](ref:notification-templates).
| Option | Description |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Title | Sends the value as a string in the `title` field of the JSON payload. Supports [notification templates](ref:notification-templates). |
| Message | Sends the value as a string in the `message` field of the JSON payload. Supports [notification templates](ref:notification-templates). |
{{< admonition type="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](ref:irm-alert-templates).
{{< /admonition >}}
### Optional notification settings
| Key | Description |
| ------------------------ | ------------------------------------------------------------------- |
| Disable resolved message | Enable this option to prevent notifications when an alert resolves. |