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:

• Users in Monte Carlo to click a button to 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.
• Monte Carlo to automatically send notifications directly to Jira to create Issues.
• Status updates from those Jira issues can also be synced back to the corresponding Incident in Monte Carlo.

Both Jira Cloud and Jira Data Center are supported.

Integration setup

An Account Owner must go to Settings > Integrations. In the Notifications and Collaboration section, click Create and select Jira, and complete the form.

For Jira Cloud

Input:

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

The Jira API token will inherit the same permissions as the user who generated it. This means that Monte Carlo will only have access to the projects and issue types that the user who generated the API Token has access to. 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

For Jira Data Center

Input:

• Display name: this gives a superficial name to the integration within Settings, e.g. “Jira production”
• Server URL: Jira Data Center URL, often expressed as jira.companyname.com
• Authentication type: select either
  • API token or password, which requires the user to enter
    • User name: Username used to log in to Jira Data Center
    • Password: Password used to og in to Jira Data Center
  • Personal access token
    • In Jira you can get this token by selecting your profile picture at the top right of the screen, then choose Profile. Once you access your profile, select Personal Access Tokens in the left-hand menu to create new tokens.

Syncing Status from Jira Issues back to Monte Carlo Incidents

Syncing the status of Jira issues back to Monte Carlo Incidents is optional and requires additional configuration.

First, map your Jira statuses to Monte Carlo statuses:

• Within the integration create/edit page, toggle Sync Jira issue status to incidents to on
• Since statuses in Jira are highly customizable, the user is asked to manually type the specific Jira statuses that should update the Incident status in Monte Carlo.
• The status will sync when the status is updated in Jira. A status update from within Monte Carlo does not have any impact on the status of a Jira issue.
• Note: if an Incident has multiple Jira issues associated with it, then Status syncing is disabled for that incident. This is to avoid conflicting status updates.

Second, you must configure a webhook to send Jira issue updates back to Monte Carlo:

• When you first save your Jira integration after toggling Sync Jira issue status to incidents, you will get a webhook URL. You will also be able to see this URL if you go back to edit the Jira integration.
• Configure a webhook to send Jira issue updates to this URL, following these Jira docs on configuring webhooks
• When enabling the webhook, select the event Issue: updated to trigger the webhook to be sent.
• Expect latency of 30-60 seconds between Jira and Monte Carlo.

Creating a Jira Issue from a Monte Carlo Incident

After the integration is set up, a user has two different ways they can create a Jira Issue from a Monte Carlo Incident:

• Add Jira as a recipient in an Audience. Notifications sent to Jira will generate an Issue. This is only supported in Notifications 2.0.
• click a button from Incident IQ that lets them create a new Jira Issue or link an existing one

To create a Jira Issue from Incident IQ, first click the Jira button on the top-right.

Once clicked, a slide-out opens. If creating a new Jira issue, the user can input the Project, Issue Type, Summary, and Description. Summary and Description are 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. This process can be repeated to link multiple Jira issues to the Incident.

Interacting with Jira Issues from within Monte Carlo

Once a Jira issue is created or linked to an Incident, it is visible from within Incident IQ and from the Incident Feed. There is also a filter on the Incident Feed to only see Incidents with a Jira Issue.

Once a Jira issue is created or linked to an Incident, any Slack notifications from that Incident are updated to show that the link was made.