Add Jira integrations to your project

With Firebase's Jira integration, your Firebase project can post to a Jira project in response to events in certain Firebase services, like new or regressed issues in Crashlytics. You can also link individual Crashlytics issues to Jira issues.

Prepare Jira for integration with Firebase

Create an API Token (Jira Cloud only)

Before you set up the integration in Firebase, you have to generate an API token in Jira Cloud. To do that, open Jira's API tokens settings, then click Create API token. Save this API token somewhere secure, as you'll need it later.

Create a "Bug" issue type

Firebase Jira integration creates issues with the type "Bug". You'll need to create this issue type if it doesn't already exist in your project:

1. In the Jira console, navigate to Project Settings.
2. Click Issue types.
3. Click Add issue type.
4. Select "Bug", or enter it manually.

Enable the Jira integration in the Firebase Console

Jira Cloud

1. In the Firebase Console, navigate to Integrations.
2. Click Install on the Jira integration card.
3. Click Set up Jira integration.
4. Enter your Jira project URL in the following format:
   https://[workspace-name].atlassian.net/projects/[project-key]
5. Enter your Jira login email and your API token.
6. Click Verify & save.

Jira Server

1. In the Firebase Console, navigate to Integrations.
2. Click Install on the Jira integration card.
3. Click Set up Jira integration.
4. Enter your Jira project URL in the following format:
   https://[server-name.com]/projects/[project-key]
5. Enter your Jira login email and your API token.
6. Click Verify & save.

Configure Jira triggers

You can configure alerts by app and event type. For example, you can turn off notifications in your testing app or route notifications about different apps to different projects.

Firebase's Jira integration currently allows you to send alerts in response to three event types:

• New Crashlytics issues: triggered when your app experiences a crash Crashlytics hasn't seen before.
• Regressed Crashlytics issues: triggered when your app experiences a crash that you'd previously marked closed.
• Increasing Crash Velocity issues: triggered when a single crash type affects 1% of sessions in a 60 minute period for a given app version.

By default, Firebase doesn't post anything to your Jira project. Here's how to configure alerts for your project:

1. In the Firebase Console, navigate to Integrations.
2. Click Manage on the Jira integration card.
3. Find the app you want notifications for, and click the Edit.
4. For each alert type, check or uncheck Enabled.
5. Click Save.

That's it! With your configurations made, Firebase will post bugs to your specified projects when your apps have new, regressed, or increasing-velocity issues.

Linking Crashlytics issues and Jira issues

In addition to the automatically-created Jira issues that Firebase creates, it's possible to link your Crashlytics issues to existing Jira issues. You can also create a new Jira issue from the Firebase console. You'll need to enable the Jira integration before using this feature.

1. Navigate to the Crashlytics issue you'd like to link to a Jira issue.
2. Click Link to Jira.
3. Either click Create issue in Project, or paste your Jira issue URL or issue key in the space below.

Unlinking a Crashlytics issue from a Jira issue

1. Navigate to the Crashlytics issue you'd like to unlink from Jira.
2. Click Linked Issue.
3. Click More, and select Unlink.