Documentation Grafana Cloud Alerts and IRM IRM Configure Integrations Integration reference Incident integrations Jira

Jira integration for Grafana IRM

The Jira integration for Grafana IRM helps you maintain accurate issue tracking during incident response. By linking your Jira account with Grafana IRM, you can automatically create Jira issues when incidents are declared, and easily convert incident tasks to Jira issues.

Key features

• Automatic Jira issue creation when incidents are declared
• Synchronization of incident status with Jira issue status
• Bidirectional task management between IRM and Jira
• Links between IRM incidents and related Jira issues

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

Before you begin

To use the Jira integration, you need:

• A Jira Cloud account with administrative access
• An Atlassian API Token (create one at https://id.atlassian.com/manage-profile/security/api-tokens)
• Your Atlassian Server URL
• Your Atlassian user email
• Editor or Admin permissions in Grafana IRM

It’s recommended to use a Jira service account to install and manage this integration.

Configure the Jira integration

1. Navigate to IRM > Integrations in the Grafana menu
2. Select the Apps tab
3. Click the Jira tile
4. Enter the following information:
   • Atlassian Server URL (e.g., https://your-domain.atlassian.net)
   • Atlassian user email
   • Atlassian Personal API Token (the raw token, not <email>:<token>)
5. Click Install Integration

Configure automated actions

After installing the integration, configure it to automatically create Jira issues:

1. From the Jira integration settings, click Configure Actions
2. Select Create a Jira issue as the action
3. Configure the following settings:
   • Jira Project to create issues in
   • Issue type to be created (Bug, Task, etc.)
   • Incident active status (e.g., In Progress)
   • Incident resolved status (e.g., Done)
4. Set the trigger to When an incident is declared
5. Click Add Action

Using the integration

Once configured, the integration will:

• Automatically create a Jira issue when an incident is declared in Grafana IRM
• Update the Jira issue status when the incident status changes
• Allow you to link IRM tasks to Jira issues
• Enable conversion of IRM tasks to Jira issues and vice versa

Task management with Jira

To link an IRM task to a Jira issue:

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

Troubleshooting

If you encounter issues with the Jira integration:

• Verify that your Atlassian API Token is valid and has not expired
• Check that your Atlassian Server URL is correct
• Ensure you have the necessary permissions in Jira
• Verify that the selected Jira project exists and is accessible