Jira

Sometimes, an Incident detected by Monte Carlo may take weeks to fix, or requires work from someone outside the data team. Converting Incidents like these into issues in Jira makes it easy to track work over weeks or months, and mobilize resources from teams not in Monte Carlo.

This integration allows Monte Carlo users to easily convert an Incident into an Issue in Jira, or link an existing Issue. Multiple Jira Issues may be linked or created from a single Incident in Monte Carlo.

The experience today is as follows:

1597 — From within Incident IQ, a user can click a button to create a Jira Issue.

1290 — This opens a slide-out, which allows the user to either link an existing Jira issue, or create a new one.
If creating a new Jira Issue, input basic information like the Project, Issue Type, Summary, and Description. Description is pre-populated with some information about the Incident and a URL to link back to the Incident in Monte Carlo.
Click **Create**, and the user is given a confirmation that an Issue has been created, along with a 1-click link to view the Issue in Jira.

1592 — A 1-click link to the Jira issue also remains available on the IncidentIQ page.

Once a Jira issue is created from an Incident, any Slack notifications from that Incident are updated to show an Issue was created.

Setup

Currently, only Jira Cloud is supported. To set up this integration, an Account Owner must go to Settings > Integrations. In the Notifications and Collaboration section, click Create and select Jira. You will need:

Server URL: expressed as https://{{companyname}}.atlassian.net/
User name: expressed as a user email address
API Token: see this link to see how to obtain a Jira API token
Display name: this gives a superficial name to the integration within Settings, e.g. “Jira production”

The Jira API token will inherit the same permissions as the user who generated it. The permissions needed for this integration to function are minimal, as Monte Carlo only needs to:

List projects
List issue types for a given project
Create Issue Project Permission

To do that, the following permissions are sufficient:

Browse Projects
Create Issue Project Permission

📘
Note: Monte Carlo will only have access to the projects and issue types that the user who generated the API Token has access to.