Jira Issues - Cloud

The BigPanda for Jira integration allows you to automatically create actionable Jira Issues based on high-level correlated BigPanda incidents. Jira issues are synchronized with the corresponding BigPanda alerts allowing you to continue working in Jira while benefitting from BigPanda’s tools. The integration allows you to configure parameters in Jira for the customization of each project instance.

Supported Versions

Type

Authentication Type

Jira Cloud

Native App

API Key and Bearer Token

Key Features

  • Bidirectional Logic: Configurable settings that allow resolve events for BigPanda incidents to automatically resolve a Jira issue. In addition, you can enable that incidents reopened in BigPanda can reopen a Jira issue.
  • Priority synchronization: Priority levels set for BigPanda incidents can automatically set the priority levels of corresponding Jira Issues.
  • Direct link to BigPanda incident: Links directly from the Jira issue to the BigPanda incident allowing you to view the incident details, the incident preview page, and the incident timeline. You can also view the alerts and changes occurring in the BigPanda console.
  • Multi-project integration: Allows you to set up an integration for each of your Jira projects.

How It Works

This integration synchronizes BigPanda incidents and Jira Issues. When a BigPanda incident is shared through the Jira integration a corresponding issue is created in Jira with details of the correlated alerts and links to the BigPanda incident. Changes occurring to the BigPanda Incident will update the corresponding Jira issue. Additionally, if changes occur to the Jira issue, then it updates the corresponding BigPanda.

❗️

Classic Software Projects

Currently, only classic software projects are supported with the BigPanda Plugin. If a Next-Gen Project is configured, the plugin will not successfully create Jira Issue.

Configuring the Integration in Jira

The BigPanda App makes it easy to configure new projects and customize them to the desired specifications. This is achieved by providing a simple form that is used to set the behavior of the integration and the bi-directional logic.

These are the steps to set up an integration for a new project:

  1. In the Projects section, select Add Project. The Project Configuration dialog box appears.
  1. Configure the Project Configuration settings.
Example of a Project Configuration dialog boxExample of a Project Configuration dialog box

Example of a Project Configuration dialog box

The dialog box makes it easy to set up a new integration with a project since the form automatically provides the list of Jira projects available for integration and setup. These are the parameters available:

Parameter Name

Description

BigPanda App Key

App Key provided by the on-screen instructions in BigPanda for this integration

Jira Project

Select the project you want to create the integration for. All your Jira projects are listed here.

Jira Issue Type

Select an issue type for your project from the drop-down menu:
Ex: Story, Bug, Epic...

  1. Configure the Bi-Directional Logic for closing and re-opening incidents and issues parameters for a specific project. Here are the available parameters and what they do:

Parameter Name

Action

Auto Resolve BigPanda Incident

Enable this toggle to automatically resolve a BigPanda incident when a corresponding Jira issue marked as done or resolved.

Auto Resolve Jira Issues

Enable this toggle to automatically resolve a Jira issue when a corresponding Bigpanda incident is resolved.

Auto Re-Open Jira Issues

Enable this toggle to reopen a Jira issue when a corresponding BigPanda incident is reopened. Disable if you want to create a new Jira issue when the corresponding BigPanda incident is reopened.

Re-Open Window (min)

If you enabled the Re-Open Jira Issues, you can set the timeframe during which the Jira issue can be reopened. If this time frame has passed, then a new Jira issue is created.

  1. To specify the initial status of a Jira Issue based on various BigPanda actions, configure the Status Mapping parameters.
Example of a Status MapExample of a Status Map

Example of a Status Map

The BigPanda Jira App automatically fetches all the statuses defined in your workflow for that project and provides them in a drop-down menu that you can use to set the behavior of the creation, resolve and re-open logic within Jira. These are the parameters:

Parameter Name

Action

Create Jira Issue as..

When a new issue is created by BigPanda it will be opened in this status.

Resolve Jira Issue as...

When an incident is resolved in BigPanda and the logic is enabled in the configuration, then the issue will be moved to this status.

Re-open Jira Issue as...

When an incident is re-opened in BigPanda and the logic is enabled in the configuration, it will move the Jira issue from the resolution status to this new status.

  1. Configure the Priority Mapping settings for each priority level.
Example of a Priority MapExample of a Priority Map

Example of a Priority Map

The list of priorities is displayed. If a priority is defined for a BigPanda incident, you can synchronize it with the Jira issue priority. In case there is no priority tag for a BigPanda incident, you can set your own default priority. You can rename the list of priorities to suit the needs of your organization. For example, you can rename P1, P2, P3, P4, and P5 as Critical, High, High, Medium, and Low.

📘

Issue Types and Statuses Can Differ between Projects.

After selecting a project, the Issue types, statuses and priorities are dynamic and are based on the available parameters in the drop-down menu for that project.

🚧

Reconfigure Priority Mapping in Jira for Updates in BigPanda's Priority Tags

For updates done in BigPanda to the Priority Tags, you will need to reconfigure the Priority Mapping in the Jira Project for these updates to take effect.

🚧

Enable Priority Tags in BigPanda

The priority tags within the BigPanda need to be enabled for them to appear in the Priority Map section, otherwise, the BigPanda Application will use the default value for all priorities.

  1. In Issue Summary, define a description template for a Jira issue. By default, BigPanda provides the following template:
Default TemplateDefault Template

Default Template

However, you can customize the way the BigPanda incident information is presented in the Jira issue by using the Jira Markup Syntax (For more information click here) and using the provided parameterized fields:

Jira Description Field

Description

{{priority}}

Priority tag from BigPanda

{{status}}

The incidents

{{start_time}}

Time of when the incident started in BigPanda

{{incident_link}}

Link that points back to the incident in BigPanda

{{env_name}}

The name of the environment from BigPanda
See Environment

{{env_id}}

The id of the environment

{{alert_count}}

Total number of alerts in the incident in BigPanda

{{active_alert_count}}

Number of alerts either in a critical or warning state in the incident in BigPanda

{{critical_count}}

Number of critical alerts in the BigPanda incident

{{warning_count}}

Number of warning alerts in the BigPanda incident

{{ok_count}}

Number of resolved alerts in the BigPanda incident

{{acknowledged_count}}

Number of acknowledged alerts in the BigPanda incident

{{unknown_count}}

Number of unknown alerts in the BigPanda incident

{{alerts_table}}

The list of alerts from the BigPanda Incident

  1. Select Save. After setting your configurations, the shared BigPanda incidents that created Jira Issues are displayed on the task board according to the configurations you made.

View the Jira Issue Workflow

  1. Select the Jira Issue from the list of your projects. The Issue Glance dialog box opens. The issue summary appears in the description field in the left pane. The issue glance appears in the right pane. The glance provides a quick overview of information relating to an issue, including the BigPanda incident and its priority status.
Example of a Jira IssueExample of a Jira Issue

Example of a Jira Issue

  1. To change the configurations, set the following parameters:

Parameter

Description

Description

Configure the description template based on the Issue Summary.

Issue Status

Select the issue status from the drop-down menu.

Priority

Select the issue priority from the drop-down menu.

  1. To link to the BigPanda console, select the BigPanda Incident.

  2. Select Correlated Alerts. The Alerts tab displays a table of all BigPanda alerts associated with the Jira Issue, including the alert status and its primary and secondary properties.

  3. Select Related Changes. The Changes tab displays any changes determined to be suspect or match changes for the associated alert. A suspect change indicates a change that may be related to the current alert. A match change indicates a change determined to be related to the current alert. The table remains empty if no suspect or match changes related to the alert are found.

  4. For extra details, select any of the following links:

Parameter

Description

View Timeline

Displays the incident timeline in BigPanda.

Incident Preview

Displays the incident preview page where you can see the latest incident status without logging in to BigPanda.

View Incident

Links directly to the incident feed and displays the highlighted incident and the incident overview.

Updated 2 months ago

Jira Issues - Cloud


The BigPanda for Jira integration allows you to automatically create actionable Jira Issues based on high-level correlated BigPanda incidents. Jira issues are synchronized with the corresponding BigPanda alerts allowing you to continue working in Jira while benefitting from BigPanda’s tools. The integration allows you to configure parameters in Jira for the customization of each project instance.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.