Jira
Track and resolve bugs faster by connecting errors from Sentry with Jira issues.
This integration needs to set up only once per organization, then it is available for all projects.
Install
Note
- Navigate to Settings > Integrations > Jira.
Install the Sentry app through the Jira marketplace.
Select which Sentry organizations you’d like to use with Jira, and Save Settings.
In Sentry, you’ll see a new Jira instance appear on the Integrations page.
Jira should now be authorized for all projects under your Sentry organization.
Jira Server
Generate an RSA public/private key pair
To generate an RSA public/private key pair, run the following commands in your terminal window one by one.
openssl genrsa -out jira_privatekey.pem 1024
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
Create a new application link in Jira
In Jira, click the gear icon, then Applications > Application Links.
Enter the following as the application URL:
https://sentry.io/extensions/jira_server/setup/
Click "Create New Link". If you see a warning that “No response was received from the URL you entered,” ignore and click "Continue".
In the resulting dialog, fill out the form as follows:
Application Name Sentry Application Type Generic Application Service Provider Name Sentry Consumer Key (your choice, but keep this handy for the next step) Shared Secret sentry Request Token URL https://sentry.io Access Token URL https://sentry.io Authorize URL https://sentry.io Create Incoming Link No Click "Continue". This will return you to the Configure Application Links page, where you'll see an application called Sentry.
Click the pencil icon next to the Sentry application.
On the lefthand side of the resulting modal, click "Incoming Authentication". Fill out the form as follows, and press Save:
Consumer Key (the consumer key from Step II.4) Consumer Name Sentry Public Key (the public key you created in Section I) Consumer Callback URL https://sentry.io/extensions/jira_server/setup/ Allow 2-Legged OAuth no
Connect your Jira Server application with Sentry
Confirm Sentry's IP ranges are allowed.
- Navigate to Organization Settings > Integrations.
- Next to Jira Server, click "Install".
- In the resulting modal, click "Add Installation".
- In the resulting window, enter the base URL for your Jira Server instance, your consumer key, and your private key. Click "Submit". Then, complete the OAuth process as prompted.
- In Sentry, you’ll see a new Jira Server instance appear on the Integrations page.
Jira should now be authorized for all projects under your Sentry organization.
Configure
Use Jira to leverage issue management, issue syncing, and receive notifications about changes to issue status.
Issue Management
Issue tracking allows you to create Jira issues from within Sentry, and link Sentry issues to existing Jira Issues.
Note
To configure Issue management, once you’ve navigated to a specific Sentry issue, you’ll find the Linked Issues section on the right hand panel.
Here, you’ll be able to create or link Jira issues.
Issue Sync
Sync comments, assignees, and status updates for issues in Sentry to Jira, to minimize duplication. When you delegate an issue to an assignee or update a status on Jira, the updates will also populate in Sentry. When you resolve an issue in Sentry, the issue status will automatically update in Jira.
Note
To configure Issue sync, navigate to Organization Settings > Integrations, and click "Configure" next to your Jira Server instance. On the following page, you’ll see options of what information you’d like synced between Sentry and Jira.
Note
If you hit a 4xx or 5xx error during or after setting up the Jira Server integration, please take a look at this Help Center article.
Issue Notifications
Alert notifications in Sentry can be routed to many supported integrations, but by default are aimed at email. You will need to configure a project’s Alert Rules to properly route notifications to a specific integration.
Troubleshooting
If you're having trouble setting up Sentry with your on-premise integration, verify the following:
- The provided installation URL is a fully qualified domain name (FQDN), which is resolvable on the internet.
- The IP addresses Sentry uses to make outbound requests are allowed.
- Sentry's access to your installation URL is not path restricted.