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. This is only supported in accounts that are on Notifications 2.0.
  • Status updates from those Jira issues can also be synced back to the corresponding Incident in Monte Carlo.

Currently, only Jira Cloud is supported.

Setup

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.

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.
An example where the user has mapped 'Completed' and 'In progress' in Jira to 'Fixed' and 'Investigating' in Monte Carlo

An example where 'Completed' and 'In progress' in Jira is mapped to 'Fixed' and 'Investigating' in Monte Carlo

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.
After you click 'Create', you will be given a Webhook URL to sync status updates from Jira back to Monte Carlo

After you click 'Create', you will be given a Webhook URL to sync status updates from Jira back to 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.

1597

The button to create or link a Jira Issue.

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.

1290

Users can easily pass information about the Incident into the Jira Issue.

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.

1-click link to the Jira issue is available from Incident IQ, along with details of the current owner and status

1-click link to the Jira issue is available from Incident IQ, along with details of the current owner and status

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.

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

Notification in Slack showing that a Jira Issue was created for this Incident