For self-managed Jira Server or Jira Data Center instances, use the Jira Server integration instead. The setup process differs from Jira Cloud.
Features
Create Jira tickets
Create a new Jira ticket directly from a Sentry issue with fields pre-populated from the error data.
Link existing tickets
Link a Sentry issue to an existing Jira ticket for quick cross-referencing.
Two-way sync
Closing a Jira ticket can resolve the linked Sentry issue, and vice versa. Assignees and comments sync bidirectionally.
Alert rule actions
Automatically create Jira tickets when an issue alert fires.
Installation
The Jira integration is installed from the Atlassian Marketplace, not directly in Sentry.Install from the Marketplace
Go to the Sentry for Jira listing on the Atlassian Marketplace and click Get it now. You must be a Jira admin to install the add-on.
Configure in Jira
After installing, open the Sentry settings panel in your Jira instance (Manage apps > Sentry). Follow the prompts to link the Jira add-on to your Sentry organization.
Issue linking
Create a new Jira ticket
- Open a Sentry issue.
- In the Linked Issues sidebar section, click Link a Jira issue.
- Select Create new issue and fill in the fields:
- Project: The Jira project to create the ticket in.
- Issue type: Bug, Task, Story, and so on.
- Title: Pre-filled with the Sentry issue title.
- Description: Pre-filled with error details.
- Any additional required fields for the selected project and issue type.
- Click Save.
Link an existing ticket
- Open a Sentry issue.
- In the Linked Issues sidebar section, click Link a Jira issue.
- Select Link existing issue and search by Jira issue key or title.
- Select the ticket and click Save.
Two-way sync
To configure sync between Sentry and Jira, go to Settings > Integrations > Jira > Configure.| Option | Description |
|---|---|
| Sync Jira status to Sentry | When a Jira ticket transitions to the configured resolved state, the linked Sentry issue is resolved. |
| Sync Sentry status to Jira | When a Sentry issue is resolved, the linked Jira ticket transitions to the configured state. |
| Sync assignees | Assigning an issue in Sentry assigns the linked Jira ticket, and vice versa. |
| Sync comments | Comments on a Sentry issue are posted to the linked Jira ticket. |
Jira project status mapping
For status sync to work, you need to map Jira projects to Sentry projects and define which Jira workflow statuses correspond to resolved and unresolved states.- In the Jira integration settings, click Add Jira project mapping.
- Select the Jira project.
- Choose the workflow status that means resolved and the one that means unresolved.
Alert rule actions
With the Jira integration installed, you can add a Create a Jira issue action to issue alert rules. When the alert fires, Sentry automatically creates a new Jira ticket.Custom field mapping
Sentry reads the field schema from Jira and renders the appropriate input type for each field when creating a ticket. Supported field types include:- Text and text area
- Single select and multi-select
- Number
- Date and date-time
- User picker
- Team picker (Jira Software)
- Issue link (hidden by default)
Jira Server
The Jira Server integration supports Jira Data Center and Jira Server (self-managed). To install it:Navigate to integrations
In Sentry, go to Settings > Integrations and find Jira Server. Click Install.
Create an application link in Jira
Follow the on-screen instructions to create an application link (OAuth 1.0a) in your Jira instance and copy the consumer key.