API Key and Bearer Token
- 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.
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.
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:
- In the Projects section, select Add Project. The Project Configuration dialog box appears.
- Configure the Project Configuration settings.
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:
BigPanda App Key
App Key provided by the on-screen instructions in BigPanda for this integration
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:
- 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:
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.
- To specify the initial status of a Jira Issue based on various BigPanda actions, configure the Status Mapping parameters.
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:
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.
- Configure the Priority Mapping settings for each priority level.
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.
- In Issue Summary, define a description template for a Jira issue. By default, BigPanda provides the following 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
Priority tag from BigPanda
Time of when the incident started in BigPanda
Link that points back to the incident in BigPanda
The name of the environment from BigPanda
The id of the environment
Total number of alerts in the incident in BigPanda
Number of alerts either in a critical or warning state in the incident in BigPanda
Number of critical alerts in the BigPanda incident
Number of warning alerts in the BigPanda incident
Number of resolved alerts in the BigPanda incident
Number of acknowledged alerts in the BigPanda incident
Number of unknown alerts in the BigPanda incident
The list of alerts from the BigPanda Incident
- 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.
- 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.
- To change the configurations, set the following parameters:
Configure the description template based on the Issue Summary.
Select the issue status from the drop-down menu.
Select the issue priority from the drop-down menu.
To link to the BigPanda console, select the BigPanda Incident.
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.
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.
For extra details, select any of the following links:
Displays the incident timeline in BigPanda.
Displays the incident preview page where you can see the latest incident status without logging in to BigPanda.
Links directly to the incident feed and displays the highlighted incident and the incident overview.
Updated 2 months ago