JIRA Server Extension Guide

This extension is only for JIRA Server 7.2+, not JIRA Cloud. Please see our JIRA Cloud Extension Guide for more information.

In PagerDuty

  1. From the Configuration menu, select Extensions.
  2. Click + New Extension and select JIRA Server. You will be prompted to open the JIRA Server configuration page.
  3. From the JIRA Server configuration page, copy the Authentication Token
    to be used later on in this guide.

In JIRA

    1. From the JIRA Administration menu in the top right corner, click Add Ons.

    1. Find the PagerDuty for Jira Server add-on in the Atlassian Marketplace and install it.
    2. After returning to the Manage Add On page, select the PagerDuty Add On, and click Configure.

    1. Add the Authentication Token you copied from the PagerDuty extension configuration and click Save.

In PagerDuty

    1. Add the URL of your JIRA server and click Connect JIRA Server.

    1. Select a PagerDuty service and corresponding JIRA project, then click Connect JIRA Project.

    1. Select a JIRA Issue Type and a JIRA Status corresponding to the Open and Resolved PagerDuty incident status.

  1. Click Create Test Issue to test the connection between PagerDuty and your JIRA Server. You will see a success message at the top of the modal and the new ticket will be visible in JIRA.
  2. Click Save, and you’re done!

FAQ

What if my JIRA Server is behind a firewall?

In order to allow bidirectional integration between PagerDuty and your JIRA Server, it may be necessary for you to configure your firewall to allow for incoming traffic from PagerDuty. You can find more information about this and whitelisting IP addresses in our knowledge base. You’ll specifically need to whitelist IPs for PagerDuty webhooks and the REST API.

Does the JIRA Server integration support mandatory custom fields?

The integration does not support mandatory custom fields. This integration will not work if the connected JIRA project requires a mandatory custom field.