---
title: "Jira integration for Grafana IRM | Grafana Cloud documentation"
description: "Configure Jira integration for Grafana IRM to automate issue creation and task management"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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](/docs/grafana-cloud/observe-and-act/respond-to-incidents/manage-incidents/collaborate/manage-tasks)

## Before you begin

> Note
> 
> This integration is available for Jira [Cloud](https://www.atlassian.com/software). Currently, self-hosted Jira instances are not supported.

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](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.

> Note
> 
> Grafana IRM only sends the `Summary`, `Description`, `Project`, and `IssueType` fields when it creates the Jira issue. Issue creation fails if your Jira project requires other fields, or if you select an issue type that needs a parent issue, such as **Subtask**.

## 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