Jira integration for Grafana IRM

The Jira integration for Grafana IRM handles issue events sent from Jira webhooks. The integration provides grouping, auto-acknowledge and auto-resolve logic via customizable alert templates.

Configure Grafana IRM to receive alerts from Jira

In Grafana IRM, navigate to IRM > Integrations > Monitoring Systems
Click + New integration
Select Jira from the list of available integrations
Enter a name and description for the integration, click Create
A new page will open with the integration details. Copy the IRM Integration URL from HTTP Endpoint section. You will need it when configuring Jira

Configure Jira to send alerts to Grafana IRM

Create a new webhook connection in Jira to send events to Grafana IRM using the integration URL above.

Refer to Jira documentation for more information on how to create and manage webhooks

When creating a webhook in Jira, select the following events to be sent to Grafana IRM:

Issue - created
Issue - updated
Issue - deleted

After setting up the connection, you can test it by creating a new issue in Jira. You should see a new alert group in Grafana IRM.

Grouping, auto-acknowledge and auto-resolve

Grafana IRM provides grouping, auto-acknowledge and auto-resolve logic for the Jira integration:

Alerts created from issue events are grouped by issue key
Alert groups are auto-acknowledged when the issue status is set to “work in progress”
Alert groups are auto-resolved when the issue is closed or deleted

To customize this behaviour, consider modifying alert templates in integration settings.

Configure Grafana IRM to send data to Jira

Grafana IRM can automatically create and resolve issues in Jira via outgoing webhooks. This guide provides example webhook configurations for common use cases, as well as information on how to set up a user in Jira to be used by Grafana IRM.

Prerequisites

Create a new user in Jira to be used by Grafana IRM. Obtain an API token for the user, these credentials will be used to communicate with Jira REST API
Make sure the user has appropriate permissions to create and update issues in Jira

Create issues in Jira

The steps below describe how to create an outgoing webhook in Grafana IRM that will allow to automatically create issues in Jira from Grafana IRM alert groups.

Create a new Outgoing Webhook in Grafana IRM, and configure it as follows:

Trigger type: Alert Group Created
Integrations: Select integrations that will trigger the webhook
HTTP method: POST
Webhook URL:

https://<INSTANCE>.atlassian.net/rest/api/2/issue

Replace <INSTANCE> with your Jira instance.

Username: Email of the Jira user
Password: API token of the Jira user

Use the following JSON template as webhook data:

{
  "fields": {
    "project": {
      "key": "<PROJECT_KEY>"
    },
    "issuetype": {
      "name": "[System] Incident"
    },
    "summary": "{{alert_group.title}}",
    "description": "This issue is created automatically by Grafana IRM. Alert group {{alert_group.id}}: {{alert_group.permalinks.web}}"
  }
}

Replace <PROJECT_KEY> with the key of the project in Jira.

Note
You might want to use a different issuetype.name depending on your Jira instance configuration and use case.

Resolve issues in Jira

The steps below describe how to create an outgoing webhook in Grafana IRM that will allow to automatically resolve issues in Jira when an alert group is resolved in Grafana IRM.

Trigger type: Resolved
Integrations: Select integrations that will trigger the webhook
HTTP method: POST
Webhook URL:

https://<INSTANCE>.atlassian.net/rest/api/2/issue/{{responses.<WEBHOOK_ID>.key}}/transitions

Replace <INSTANCE> with your Jira instance, and <WEBHOOK_ID> with the ID of the webhook used for creating issues.

Username: Email of the Jira user
Password: API token of the Jira user

Use the following JSON template as webhook data:

{
  "transition": {
    "id": "<TRANSITION_ID>"
  },
  "fields": {
    "resolution": {
      "name": "Done"
    }
  },
  "update": {
    "comment": [
      {
        "add": {
          "body": "Resolved by Grafana IRM.",
          "public": false
        }
      }
    ]
  }
}

Replace <TRANSITION_ID> with the ID of the transition specific to your Jira instance. See here for more info on how to find the transition ID in Jira UI, or use the REST API endpoint to get the list of available transitions.

Advanced usage

The examples above describe how to create outgoing webhooks in Grafana IRM that will allow to automatically create and resolve issues in Jira.

Consider modifying example templates to fit your use case (e.g. to include more information on alert groups). Refer to outgoing webhooks documentation for more information on available template variables and webhook configuration.

For more information on Jira REST API, refer to Jira REST API documentation.