Jira data source
Jira is an issue tracking, project management, and workflow automation tool. Get the whole picture of your development process by combining issue data from Jira with application performance data from other sources.
Note
The Jira data source plugin is an Enterprise plugin that requires either a Grafana Cloud account or an activated Grafana Enterprise license.
Supported Jira environments
You can use the Jira data source plugin to connect to the following Jira environments:
- Jira Cloud
- Jira Data Center
- Jira Server
The plugin also supports Jira Service Management fields, including SLA metrics, approvals, and customer feedback.
Requirements
Before you configure the Jira data source, you need the following:
- Grafana version 11.0 or later.
- An Atlassian account with access to a Jira project.
- Any free or paid Grafana Cloud plan or an activated on-prem Grafana Enterprise license. Contracted Cloud customers should refer to their agreement.
- A Jira API token for authentication. To create a token, refer to Manage API tokens for your Atlassian account.
- For Jira Cloud, Data source can be configured with API Token with Scopes using Cloud Id. To use Jira API token with scopes refer to Get the cloudid for your site
- Port 8080 enabled
Known limitations
Custom field types from Jira add-ons may not be supported.
Import a dashboard
The Jira data source plugin includes the following pre-built dashboards:
- Jira Demo - A demonstration dashboard showcasing velocity charts, sprint burndown, issue counts, and time-to-resolution metrics.
- Jira JSON Fields demo - Examples demonstrating how to work with complex Jira fields that return JSON data.
Note
These dashboards are starting points that demonstrate the data source’s capabilities. You’ll need to customize the JQL queries, project keys, and field names to match your Jira instance before the dashboards display your data.
To import a dashboard:
- Go to Connections > Data sources.
- Select your Jira data source.
- Click the Dashboards tab.
- Click Import next to the dashboard you want to use.
- Edit each panel to update the JQL queries with your project keys and field names.
For more information about importing dashboards, refer to Import a dashboard.
Get started
The following documents will help you get started with the Jira data source:
Additional features
Once you have configured the data source, you can:
- Add Annotations to overlay Jira events on your graphs.
- Configure and use Template variables for dynamic dashboards.
- Add Transformations.
- Set up Alerting to monitor your Jira data.
Plugin updates
To update the plugin, refer to Update a plugin.
Note
If you’re using Grafana Cloud, plugins are updated automatically.
