Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Configurebreadcrumb arrow Integrationsbreadcrumb arrow Configure integrations
Grafana Cloud

Configure integrations for Grafana IRM

This guide explains how to set up, customize, and manage integrations in Grafana IRM.

You can manage or view existing integrations at any time in the Integrations tab of Grafana IRM. OnCall and Incident integrations remain distinct and have different setup and management processes:

  • OnCall integrations are listed under the Monitoring systems tab
  • Incident integrations are found under the Apps tab

Before you begin

Before configuring an integration, consider the following:

  • Identify the integration type – OnCall integrations manage alert ingestion and escalation, while Incident integrations automate response workflows.
  • Verify API access – Some integrations require API tokens or service credentials.
  • Check permissions – Ensure you have the necessary permissions in Grafana IRM and the tool you are integrating with.

Configure an OnCall integration

OnCall integrations enable alert ingestion and automated routing and escalation.

Add a new integration

  1. Navigate to the Integrations tab in Grafana IRM and select Monitoring systems.
  2. Click + New integration.
  3. Select an integration from the list. If your desired integration is not listed, select Webhook and refer to the webhook documentation.
  4. Provide a title, description, and assign it to a team, then click Create Integration.
  5. The integration details page will display the HTTP Endpoint URL for receiving alerts. Copy this URL for use in your tool, and click How to connect for provider-specific setup instructions.
  6. Configure your tool to send alerts to Grafana IRM.
  7. Click Send demo alert to test the integration.

Customize an OnCall integration

You can configure the integration to refine how alerts are handled:

  • Configure routing and escalation – Direct alerts to specific teams based on labels or other alert data.
  • Add labels – Labels help route alert groups and organize integrations.
  • Customize alert templates – Adjust grouping, auto-resolution, and auto-acknowledge templates.
  • Edit appearance templates – Customize how alerts appear in notifications, SMS, phone calls, and UI.
  • Test alert handling – Send demo alerts to validate routing, templates, and escalations.
  • Enable debug maintenance mode – Prevent real notifications while testing new configurations.

Manage maintenance mode

Use Maintenance Mode to suppress alerts during infrastructure maintenance:

  1. Navigate to the Integration page.
  2. Click the More options menu (⋮) and select Start Maintenance Mode.
  3. Choose one of the following:
    • Debug Mode – Test routing without sending real notifications.
    • Maintenance Mode – Suppress notifications and consolidate alerts.
  4. Set a duration and click Start.
  5. To stop Maintenance Mode early, click ⋮ and select Stop Maintenance Mode.

Enable heartbeat monitoring

Heartbeat monitoring ensures regular health checks by expecting periodic alerts. If Grafana IRM does not receive an expected alert, it will generate an alert group and escalate the issue.

To configure heartbeat monitoring:

  1. Navigate to the Integration page.
  2. Click ⋮ and select Heartbeat Settings.
  3. Set the heartbeat interval.
  4. Copy the provided Endpoint URL into your monitoring system.
  5. To disable heartbeat monitoring, click Reset.

Configure an Incident integration

Incident integrations automate collaboration, documentation, and incident tracking.

Add a new integration

  1. In Grafana IRM, go to the Integrations tab and select Apps.
  2. Click an integration tile to open the configuration page.
  3. Review integration-specific setup steps.
  4. Click Install integration.
  5. Complete any required authentication or authorization steps.

Configure automation settings

Configure available actions for the integration. These actions define automated steps that occur when an incident is declared.

Manage and edit an integration

To update an existing integration:

  1. Navigate to the Integrations tab.
  2. Select the integration you want to edit.
  3. Click ⋮ next to the integration name and select Integration settings.
  4. Make necessary updates and click Save.

Next steps