Jira

Integrating Decube with Jira allows you to create issue tickets directly on the detected incidents, streamlining your workflow and ensuring efficient incident management.

Prerequisites

An active Decube account with the necessary permissions to configure integrations.
A Jira account with administrative privileges or the required permissions to create and manage issues.

The authentication credentials is different between Jira Cloud and Jira Data Centre. Please refer to the correct section for required step for each version.

Set up Jira connection

Log in to your Decube account and navigate to the "Integrations" section under "My Account" page.
Locate the "Jira" integration and click on the "Connect" button as below.

Select your Infrastructure. There are 2 options, which depend on your organization's Jira setup: Cloud and Data centre.

Option 1: Jira Cloud

After selecting Jira Cloud option, you will need to provide the Server URL. This can be found in your workspace console settings, eg. https://your-domain.atlassian.net.
You will then need to generate an API token from your Atlassian account. This is the Atlassian guide on how to create the API token.
Provide the Jira account email which was used to generate the API token above.

Once these information is provided, click on Proceed to connect.

Option 2: Data Center

After selecting Jira Data Center option, you will need to provide the Server URL. This can be found in your workspace console settings, eg. https://your-domain.atlassian.net.
You will then need to generate an Personal Access Token from your Atlassian account. This is the Atlassian guide on how to create the API token.
Provide the Jira Account Username which was used to generate the Personal Access Token above.

Once these information is provided, click on Proceed to connect.

After successful authentication, you will see that the button to Connect to Jira now changes to: Disconnect and Manage.

Syncing Statuses from Decube to Jira

To Sync statuses from your Jira Project to Decube, Select the "Manage" option.

Add a project to begin mapping your Jira Statuses from the selected project to Decube's Statuses.

Upon Selecting a project, select "+ Map Issue".

Choose the Issue Type, Issue Status, and the corresponding Incident Status in Decube that you want to map.

Adding Jira Sync Webhook to Decube

To sync statuses from Jira to Decube and automatically close incidents, you will need to add following Jira Sync Webhook URL to your Jira account.

The steps for managing webhooks in your Jira account differs from Jira Cloud and Jira Data Centre. Please refer to the correct guide for each Manage Webhook flow:

Jira Cloud: link to Atlassian documentation
Jira Data Centre: link to Atlassian documentation

Creating Issues from Decube to Jira

To create an issue in Jira from Decube, go to the Data Quality module and select an incident. In the Incident Details Page, you will find an option to create a Jira issue.

In the "Create a Jira Issue" pop-up, the user must fill out the following fields:

Select a Project (based on the projects previously mapped here)
Choose an Issue Type
Add an Assignee
Enter a Summary
Provide a Description

Complete the process by selecting "Create This Issue." You have successfully created an issue from Decube to Jira. You can now view the following details:

Issue Title
Issue ID
Assignee
Issue Status
Options to Unlink or Modify the Jira Issue.

Modifying a Jira Issue

To Modify a Jira issue, select the "Pencil" icon on the generated Jira Issue.

Users are allowed to modify the fields below except Projects and Issue Type.

Unlinking Jira Issues from Decube

To unlink a Jira Issue from Decube, select the "Unlink" option from the generated Jira Issue ticket.

On the confirmation prompt, select "Unlink" to unlink you Issue from Decube.

When you unlink a Jira issue, Decube will stop syncing any update statuses for that issue. However, you can relink the issue at any time to resume syncing the latest status from Jira.