Jira

Learn how to setup a Bugsnag integration with Jira.

The Jira integration allows an issue to be created in Jira for errors that are reported to Bugsnag.

Configuration

In Bugsnag, set up the Jira integration from Project Settings > Issue tracker, then select Jira from the Available integrations section.

Configuration of the integration requires a Jira instance URL, project prefix key, email and API Token.

See Access permissions for a list of required permissions for the Jira user.

Configuration

Creating issues

Isuess can be create manually or automatically. Once an error has a linked issue, a comment will be added to the issue when the error changes between open and fixed, and when a comment is added to the error in Bugsnag.

Manual issue creation

Create an issue manually by clicking on the ! icon on the Bugsnag dashboard.

Create new issue

To link an error to an existing issue, select Link to an existing Jira issue and enter the issue’s URL.

Link to existing issue

Automatic issue creation

You can choose one of two ways allow Bugsnag to automatically create an issue.

  • Create an issue for each new error“: Create a linked issue as soon as a new error is seen.
  • Create an issue when a threshold is reached”: Create a linked issue only when a certain number of events are seen in specific time interval. For example, 100 events in 1 hour.

Filters can be configured to define which errors should automatically create an issue in Jira. An issue will be created the first time an error occurs in a matching release stage, if there is no existing issue.

Auto create issue

Basic filters

Basic filtering is provided for severity, type, and release stage.

  • Filter by release stage: Select the release stage(s) that you want issues to be created for from the Release stage dropdown.
  • Filter by type: Create issues for either handled or unhandled errors only. Find out more >
  • Filter by severity: Create issues for certain severities by selecting severity option(s).
  • Filter by status: Select the status option(s) that you want to include in your filter from the Status toggle.

Advanced filters

Advanced filtering leverages Bookmarks to enable you to create issues based on any field you can filter on using the filter bar. Advanced filtering is available on Standard and Enterprise plans.

Two-way sync

The Jira integration has two way sync capabilities which means that errors in Bugsnag can be kept in sync with the linked issue in Jira.

To enable two-way sync select Two-way sync and enable the automations you require.

Sync settings

The first two settings define the state that the linked Jira issue should be transitioned to when an error in Bugsnag is marked as fixed or when it is reopened.

The last two settings define the behavior when a Jira issue transitions to or away from certain states.

With the default configuration a linked Bugsnag error will be marked as fixed when the JIRA issue is transitioned to either Closed or Resolved. Correspondingly when a Jira issue is transitioned away from Closed or Resolved to any other state, the linked Bugsnag error will be reopened.

As Jira workflow states are entirely configurable, any state names can be entered and separated by commas.

Access permissions

The user credentials must have the following permissions:

  • Project permissions:
    • Create Issue
    • Edit Issue
    • Add Comments

If enabling two-way sync, the ‘Jira Administrators’ global permission is required for automatic configuration. A user without the 'Jira Administrators’ global permission can be used for two-way sync but a Jira webhook will need to be created manually by a Jira administrator. Instructions on how to do this are presented when setting up two-way sync.

Access through firewall

If your server’s security policy denies access from external IP addresses and websites, you will need to allow access to Bugsnag’s IP addresses below.

  • 104.196.245.109
  • 104.196.254.247