Integrate Jira with Datadog Incident Management
Overview
Jira is a work item and project tracking system for software teams. The Datadog Jira integration allows you to create Jira work items from Datadog incidents and sync data between the two platforms.
The Jira integration with Datadog Incident Management provides the following benefits:
- Improved Visibility: Ensure that all stakeholders are immediately informed about incidents, facilitating a quicker response.
- Supporting Existing Workflows: Integrate with your current processes, making it easier to plan work and manage priorities in Jira.
- Flexible Mapping and Configuration: With dynamic templates, you can map Datadog severities to Jira priorities, map incident statuses to Jira statuses, add custom labels, and define dynamic assignees.
- Bidirectional Sync: Teams can collaborate across Datadog and Jira simultaneously. When fields are configured for two-way sync, changes made in either platform are automatically reflected in the other.
Prerequisites
To use automatic work item creation, install the integration through the Jira Integration tile. For more information, see the Jira integration documentation.
To enable bidirectional sync, you must also configure a Jira webhook. See Configure a Jira webhook for instructions.
Setup
Configuring Jira work item creation
- On the Integration Settings page, find the Jira integration.
- Enable the Automatically create a parent work item toggle.
- Select your Jira account, project, and work item type.
- Optionally, add a condition to define when to automatically create a Jira work item. If left blank, a Jira work item is created for all new incidents.
Configuring bidirectional sync
To sync fields between an incident and its linked Jira work item, enable the Sync Data Between Incident Management and Jira toggle. When enabled, a field configuration table appears.
For each field you want to sync, configure the following:
- Jira field: The Jira field to populate. You can use any standard or custom Jira field.
- Incident field or custom value: Select a pre-populated incident field (such as Incident Title or Incident Commander), or enter a custom value using
{{ to insert incident template variables. Dynamic variables work only with string Jira field types. - Sync direction: Choose One-way sync (Datadog to Jira only) or Two-way sync (bidirectional) for each field independently. Bidirectional sync supports string, number, and date/datetime Jira field types.
To add fields beyond the defaults, click Add custom field and select a Jira field from the dropdown.
To sync comments between the Datadog incident timeline and Jira, add Comments as a custom field. When set to Two-way sync, Jira comments appear as incident timeline entries, and incident timeline entries appear as Jira comments.
Configure status and severity mappings to translate incident states and severities to Jira statuses and priorities. Each mapping can be set to One-way sync or Two-way sync independently.
Manually link additional work items
In addition to the automatically created parent work item, you can manually link additional Jira work items to an incident. These manually linked items appear alongside the auto-created work item in the incident view.
Manually created Jira work items are not synced with the incident.
Save your settings
When you save changes to the configuration of an incident type that already has active incidents, the changes apply only to future incidents. Existing incidents are not updated retroactively.
Further Reading
Additional helpful documentation, links, and articles:
