Jira Cloud Integration FAQ

Can I configure the Jira Cloud extension with multiple services?

Expand

Yes, you can. You can continue to select multiple PagerDuty services in step 7 of the In PagerDuty section above.

Can I connect Jira Cloud with more than one PagerDuty subdomain?

Expand

No, this integration can connect one Jira Cloud instance with one PagerDuty account.

Is this integration bidirectional?

Expand

Yes! You can create Jira issues from PagerDuty incidents and PagerDuty incidents from Jira issues.

🚧

Limitations

  • As users are not mapped from PagerDuty to Jira, a Jira status is not able to move the PagerDuty status to Acknowledged.
  • The flow of status changes cannot move backward in PagerDuty via mapping statuses.

You can create PagerDuty incidents from Jira issues by navigating to Integrations Extensions find Jira Cloud in your extensions list Edit on Jira Cloud Extension Page Edit the Jira Cloud Configuration check the Create incidents with JQL box and then input your JQL query in the following field.

Select "Create incidents with JQL"

Select "Create incidents with JQL"

Can I create multiple Jira issues for the same incident?

Expand

No, only one Jira issue will be created.

Can I create Jira issues from resolved PagerDuty incidents?

Expand

Yes, but it will create them with the status of Done in Jira.

What types of Jira fields can I populate from PagerDuty?

Expand

You can populate the following types of fields:

  • Any field that takes a string
  • Labels
  • Number Fields
  • Select Lists (single & multi-choice)
  • Text fields (single & multi-line)
  • URLs
  • User Pickers (single user)

How can I populate the label fields from PagerDuty?

Expand

You can populate this field while configuring the Jira Project in PagerDuty:

  1. Click the New Field button to create a custom field to sync data.
  2. Choose Constant value as the PagerDuty Attribute.
  3. A text box input will appear. Enter the value you'd like to use for the label field. Note you can add multiple values by using a comma as a delimiter. (I.E: blue,red) However, due to restrictions on Jira's end, this field does not allow any white space to be passed in.

How can I populate the Reporter or Assignee field from PagerDuty?

Expand

You can populate this field while configuring the Jira Project in PagerDuty:

  1. Click the New Field button to create a custom field to sync data.
  2. Choose Constant value as the PagerDuty Attribute.
  3. In the text box, input the Jira username.

In order for this feature to work, your user must be visible to and retrievable by the PagerDuty application, which may require that the "PagerDuty" user be a member of a Jira group that has the Browse users and groups permission.

When I update the PagerDuty incident's status, the Jira ticket isn't getting updated. What's happening?

Expand

This can happen for the following reasons:

  • The Jira project's workflow requires that some fields are populated when setting it to that given state, and those fields aren't populated. You can configure the Jira extension to populate them when creating Jira incidents using the above method.
  • The Jira project's workflow does not permit the transition between the issue states corresponding to the previous and current PagerDuty incident states. For instance, if your Jira workflow does not permit setting a To Do status Jira ticket directly to Done, and the Triggered status in PagerDuty maps to To Do while the Resolved status maps to Done, then if a triggered incident is resolved (i.e. without acknowledging it first) then the ticket will not move to the Done state because this modification is not permitted per your Jira project's configured workflow.

I just updated the priority of a PagerDuty incident, why didn't the priority update in the Jira issue?

Expand

The Jira Issue is only updated when the PagerDuty incident triggers an action via webhook, such as an acknowledgement, assignment, resolve, etc. A full list of actions can be viewed in our webhook documentation.

For example, an update to priority alone will not prompt the PagerDuty incident to sync with the Jira Issue. However, once the incident subsequently triggers an action via webhook, the priority will then sync.

If you'd like PagerDuty to trigger an action for incident priority changes, please make a feature request by contacting our Support team.

Why do I receive a "Jira test failed: cannot change status to requested state" error when trying to create a test issue?

Expand

The Create Test Issue button in PagerDuty tries to create a Jira issue and automatically maps it to the Resolved status in Jira. You will see this error if the workflow for your Jira project does not allow the Jira issue to transition directly from the Triggered status mapping to the Resolved status mapping.

Please create a Jira issue from a normal PagerDuty incident to determine if the integration works as expected.

How will the the workflow action affect the workflow automations that already exist in my Jira Cloud instance?

Expand

Jira’s automation engine does not monitor PagerDuty incident conditions to determine when to create a Jira issue. Jira’s automation engine monitors Jira issue creation/changes to determine if and when to execute a specific action. This differs from PagerDuty incident workflows, which monitor PagerDuty incident conditions to determine when to create a Jira issue.

If there are any Jira automation rules configured to update the Jira fields in your workflow action, please review those Jira automation rules to avoid conflicts.

Can I run the workflow action on multiple Jira Cloud instances?

Expand

At this time, the workflow action only allows 1 Jira Cloud instance : 1 Workflow mapping

Can I run multiple “Create Jira Issue” Workflow actions on 1 PagerDuty incident?

Expand

Yes, you can run multiple Create Jira Issue workflow actions on 1 PagerDuty incident.