Documentation Grafana Cloud Observe and act Manage on-call and incidents Connect integrations Development and operations 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
• Conversion of incident tasks to Jira issues
• 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
• The Grafana Admin org role assigned

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
• Let you convert incident tasks to new Jira issues

Task management with Jira

To convert an incident task to a new Jira issue:

1. Create a task in your incident
2. Click the task options menu (three dots)
3. Select Convert to Jira Issue
4. Select the Jira Project and Issue Type
5. Review the Issue title and optionally add an Issue Body
6. Click Create Jira Issue

The task is updated with a link to the new Jira issue. You can’t link a task to an existing Jira issue.

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