Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Connect integrationsbreadcrumb arrow Install and manage
Grafana Cloud

Install and manage integrations for Grafana IRM

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

You can view and manage existing integrations from the Integrations tab in IRM.

Before you begin

Before you configure an integration:

  • Verify API access – Some integrations require API tokens or service credentials.
  • Check permissions – Ensure you have the necessary permissions in IRM and the tool you’re integrating with.

Add an alert source integration

Alert source integrations receive alerts from your tools and monitoring systems and route them through IRM.

To add an alert source integration:

  1. Navigate to the Integrations tab and select Monitoring systems.
  2. Click + Add integration.
  3. Select an integration from the list. If your integration isn’t listed, select Webhook and refer to the custom integrations documentation.
  4. Provide a title, description, and assign it to a team, then click Create Integration.
  5. Copy the HTTP Endpoint URL from the integration details page. Click How to connect for provider-specific setup instructions.
  6. Configure your monitoring tool to send alerts to the endpoint URL.
  7. Click Send demo alert to test the integration.

For detailed set up instructions for a specific alert source, refer to the Alert source integrations section of this documentation.

Add an app integration

Chat, collaboration, and development and operations integrations connect IRM to your organizational tools. These integrations enable chat-based IRM management and help automate your incident response workflows.

To add an integration:

  1. Navigate to the Integrations tab and select Apps.
  2. Click the integration tile to open the configuration page.
  3. Review the integration-specific setup steps.
  4. Click Install integration.
  5. Complete any required authentication or authorization steps.
  6. Configure the available automation actions for the integration.

For detailed set up instructions for a specific app, refer to the chat and collaboration and development and operations sections of this documentation.

Customize an alert source integration

After you add an alert source integration, you can 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 the 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 the More options menu and select Stop Maintenance Mode.

Enable heartbeat monitoring

Heartbeat monitoring expects periodic alerts from your monitoring system. If IRM doesn’t receive an expected alert within the configured interval, it creates an alert group and escalates the issue.

To configure heartbeat monitoring:

  1. Navigate to the integration page.
  2. Click the More options menu 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.

Edit an integration

To update an existing integration:

  1. Navigate to the Integrations tab.
  2. Select the integration you want to edit.
  3. Click the More options menu and select Integration settings.
  4. Make your changes and click Save.

Next steps