GitHub integration for Grafana IRM
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Configurebreadcrumb arrow Integrationsbreadcrumb arrow Integration referencebreadcrumb arrow Incident integrationsbreadcrumb arrow GitHub
Grafana Cloud

GitHub integration for Grafana IRM

The GitHub integration for Grafana IRM connects your incident response workflow with your GitHub repositories, enhancing collaboration during incidents. This integration provides increased visibility and context by syncing critical details between incidents and GitHub issues.

Key features

  • Link incidents to specific GitHub repositories
  • Convert IRM tasks to GitHub issues and vice versa
  • Access GitHub issues directly from the incident interface
  • Track code-related changes that occur during incident response

For more information about managing tasks using the GitHub integration, refer to Add and manage tasks

Before you begin

To use the GitHub integration, you need:

  • Admin permissions in Grafana IRM
  • GitHub admin permissions to enable the Grafana IRM app
  • Access to the GitHub repositories you want to connect

Note

If you’re not a GitHub admin, request approval from your organization admin to enable the Grafana IRM app.

Configure the GitHub integration

  1. Navigate to IRM > Integrations in the Grafana menu
  2. Select the Incident tab
  3. Click the GitHub tile
  4. Click Install Integration
  5. Follow the on-screen instructions to sign in to GitHub
  6. Authorize the Grafana IRM app when prompted

After the GitHub integration is installed, you need to select which repositories to connect.

Configure repository access

To specify which GitHub repositories to connect:

  1. From the GitHub integration settings page, click Manage Integration Permissions
  2. When redirected to GitHub, click Configure
  3. Select the repositories you want to connect to Grafana IRM
    • You can choose specific repositories or grant access to all repositories
  4. Save your changes and return to Grafana IRM

Using the integration

Once configured, you can use the GitHub integration to:

  1. Create a task in your incident
  2. Click the task options menu (three dots)
  3. Select Link to GitHub issue
  4. Choose an existing issue or create a new one

View linked GitHub issues

Linked GitHub issues appear in the incident details page, providing context about code-related activities during the incident.