Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Alertingbreadcrumb arrow Configure notificationsbreadcrumb arrow Configure contact pointsbreadcrumb arrow Jira
Grafana Cloud Enterprise Open source

Configure Jira for Alerting

Use the Jira integration in a contact point to create issues in your Jira instance when alerts fire. The integration supports both Jira Cloud and Jira Server/Data Center installations.

Before you begin

Before you begin, ensure you have the following:

  • A Jira instance (Cloud, Server, or Data Center)
  • API access credentials for Jira
  • Appropriate permissions to create issues in your target Jira project

Configure Jira for a contact point

To create a contact point with a Jira integration, complete the following steps:

  1. Navigate to Alerts & IRM -> Alerting -> Contact points.
  2. Click + Add contact point.
  3. Enter a name for the contact point.
  4. From the Integration list, select Jira.
  5. Set up the required settings for your Jira configuration.
  6. Click Save contact point.

For more details on contact points, including how to test them and enable notifications, refer to Configure contact points.

Required Settings

KeyDescription
URLThe URL of the REST API of your Jira instance. Supported versions: 2 and 3 (e.g., https://your-domain.atlassian.net/rest/api/3).
Basic Auth UserUsername for authentication. For Jira Cloud, use your email address.
Basic Auth PasswordPassword or personal token. For Jira Cloud, you need to obtain a personal token here and use it as the password.
API TokenAn alternative to basic authentication, a bearer token is used to authorize the API requests. See Jira documentation for more information.
Project KeyThe project key identifying the project where issues will be created. Project keys are unique identifiers for a project.
Issue TypeThe type of issue to create (e.g., Task, Bug, Incident). Make sure that you specify a type that is available in your project.

Optional Settings

KeyDescription
TitleThe issue title. Supports templating. Max length is 255 characters.
DescriptionThe description of the issue. Depending on version of the API, it can be a text, Markdown, or JSON (v3 API only). Maximum size of the field is 32kb.
Note: JSON is not limited by the client, and if it exceeds the size, the API is likely to reject the request.
LabelsCustom labels can be added to organize and filter issues created in Jira. Supports templating, allowing dynamic label generation based on alert data.
PriorityThe priority level of the issue (e.g., Low, Medium, High, Critical).
Ensure that the priority value matches the available options for your Jira instance. You can customize priority levels in Jira here.
Resolve TransitionThe transition name to move the issue to a resolved state when an alert is resolved. Ensure that the value matches a valid transition available in your Jira workflow for the specified issue type. If this field is empty, the issue will not be transitioned to Done.
Reopen TransitionThe transition name to move the issue back to an open state when an alert reoccurs. Ensure that the value matches a valid transition available in your Jira workflow for the specified issue type. If this field is empty, the issue will not be reopened.
Reopen DurationThe time duration (in minutes) to control whether to reopen an issue that was closed within this duration or create a new one. If not specified, the most recent issue that matches the deduplication key will be updated and reopened (if reopen transition is specified).
Ignored ResolutionSpecify a resolution status that should be ignored when searching for existing issues. For example, issues with this resolution will not be reopened or updated by subsequent alerts.
Deduplication Key FieldCustom field to store the deduplication key. Must be a text field.
If not specified, the deduplication key is added to labels in the format of ALERT(hash sum). See Jira documentation for how to create custom fields.
FieldsAllows to configure custom fields of Jira issue. The field name should be of the format like customfield_10001.