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.
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
- 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 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
- 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: updatedto trigger the webhook to be sent.
- Expect latency of 30-60 seconds between Jira and Monte Carlo.
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.
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.
Updated 3 months ago