Jira Software is a project management tool that enables collaboration between teams within an organization. This guide will walk you through the process of configuring the Jira extension, so that you can create Jira issues from your PagerDuty incidents.
This extension currently only works with JIRA Cloud for PagerDuty customers on our Basic, Platform Business, Standard, or Enterprise plans. If you're using JIRA on-premises, check out our JIRA Server extension guide here.
This integration also supports Jira Service Desk.
Before you can start adding the extension to your services, your JIRA admin must first go to your JIRA instance and add the PagerDuty Add-on as follows:
- Find the PagerDuty Jira Cloud Extension add-on in the Atlassian Marketplace.
- Once the app is installed, click Manage to go into it. On the following screen, click Configure.
- You will see a key in the instructions that populate – copy this key, as it will need to be copied into PagerDuty.
- You can go into PagerDuty to add the JIRA Extension. Note that for security reasons, the key in the previous step must be used within 30 minutes.
- Go to the Configuration menu and select Extensions.
- Once you are on the Extensions page, click the Add button next to JIRA.
- Ignore step number 1, as you or your Jira admin should have already added the PagerDuty Add-on in Jira. Paste in your Jira key and click the Connect Jira Account button.
- To add the Jira extension to your service(s), select the service(s) you want to add the extension to from the dropdown. Then, select the Jira project that you want to connect to that PagerDuty service. When you are done, click Connect Jira Project.
- After Connecting, you will be taken to a configuration page where you can:
- Select a Configuration Name. We recommend to use the name of the Jira project. For example: "Create Bug (Project Name)".
- Choose a Jira Issue Type.
- Choose an option for Create Issues Mode:
- Manually: Must click the Configuration Name under the More Actions button on an incident details.
- Automatically: PagerDuty will automatically create Issues in Jira
- Map the status of PagerDuty incidents to the status of Jira Issues.
- Optionally, sync PagerDuty incident priority levels with Jira priority levels.
- Optionally, sync custom fields between a PagerDuty Attribute and Jira Issue Field Name.
- To create a Jira issue from a PagerDuty incident, go to Configuration > Services > click to your Service. Then open one of the incidents on your service.
- On the incident details page of your incident, click More Actions > Create Jira Issue.
- When a JIRA issue has been created, you will see a confirmation message appear, and you can click to View Jira Issue, which will open the JIRA issue in a new tab. If you refresh the page, you will also see it listed in the incident.
PagerDuty’s Jira Software integration supports Jira Ops projects. These projects can be connected to PagerDuty Services using the instructions above. If you already have PagerDuty connected to your Jira Cloud instance, you will need to delete your Jira configuration from PagerDuty, then re-setup the integration. This is so that an additional authorization step can be performed.
It is highly recommended that you document existing mappings you may have between PagerDuty and Jira.
To delete the configuration data:
- Go to the Configuration menu and select Extensions
- Once you are on the Extensions page, click Jira Cloud
- Expand the “How to uninstall” link under the configuration table
- Press the Delete Configuration button
Yes you can, you can continue to select multiple PagerDuty services in step 4 under the In PagerDuty section.
Yes! You can create Jira issues from PagerDuty incidents and PagerDuty incidents from Jira issues.
No, only one Jira issue will be created.
Yes, but it will create them with status "Done" in JIRA.