Set up Crashlytics alerts to Jira

After setting up the Firebase integration with Jira, your Firebase project can post to a Jira project in response to events reported by Crashlytics, like new, regressed, or increasing-velocity issues. 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

The Firebase integration with Jira 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.

Set up the Jira integration in the Firebase Console

Jira Cloud

1. Sign in to the Firebase console, then select your project.
2. Click , then select Project Settings. Select the Integrations tab.
3. On the Jira integration card, click Install.
4. Click Set up Jira integration.
5. Enter your Jira project URL in the following format:
   https://[workspace-name].atlassian.net/projects/[project-key]
6. Enter your Jira login email and your API token.
7. Click Verify & save.

Jira Server

1. Sign in to the Firebase console, then select your project.
2. Click , then select Project Settings. Select the Integrations tab.
3. On the Slack integration card, click Install.
4. Click Set up Jira integration.
5. Enter your Jira project URL in the following format:
   https://[server-name.com]/projects/[project-key]
6. Enter your Jira login email and your API token.
7. Click Verify & save.

Configure alert settings

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

Event types

The Firebase integration with Jira allows you to send alerts in response to three event types:

• New issues: triggered when your app experiences a crash that Crashlytics hasn't seen before.
• New non-fatal issues: triggered when your app experiences a non-fatal issue Crashlytics hasn't seen before.
• Regressed issues: triggered when your app experiences a crash that you'd previously marked closed.
• Increasing-velocity issues: triggered when a single crash or ANR type impacts a percentage of users in a 30-minute period for a given app version.

Configure settings for each app

Here's how to configure alerts for each app in your Firebase project:

1. Sign in to the Firebase console, then select your project.
2. Click , then select Project Settings. Select the Alerts tab.
3. Go to the Crashlytics alerts card. Select the app you want to configure from the dropdown menu.
4. Select the Jira project where you want to send alerts for this app.
5. For each type of alert, select from the dropdown whether you want to send that type of alert to Jira.
6. Repeat these steps for each app that you want to configure.

That's it! Firebase will post bugs to your specified Jira projects if 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.