--- title: Jira description: Create issues in Jira and Jira Service Management. breadcrumbs: Docs > Integrations > Jira --- # Jira ## Overview{% #overview %} Atlassian Jira is a project management and issue tracking tool for teams to coordinate work and handle tasks efficiently. Integrate with Jira or Jira Service Management to: - Create and update issues using `@jira` mentions in monitor notifications - Receive a Datadog event each time a new Jira issue is opened - Manually create new Jira issues - Link new or existing Jira issues to a Datadog incident or case - Automate Jira issue creation and send incident attributes to Jira attributes - Automate Jira issue creation and sync case and Jira attributes ## Setup{% #setup %} ### Create an application link in Jira{% #create-an-application-link-in-jira %} #### Jira Cloud instructions{% #jira-cloud-instructions %} 1. Navigate to Jira. 1. Click the Gear icon in the right corner and select **Jira Apps**. 1. In the left menu under **Integrations**, click **Application links**, and then click **Create link**. 1. Select the **Direct application link** checkbox, enter the URL `https://` and click **Continue**. 1. Ignore the warning "No response was received from the URL you entered" and click **Continue**. 1. Fill in the form as follows and click **Continue**. | Field | Input | | --------------------- | ------------------------------- | | Application Name | `{Enter a name (e.g. Datadog)}` | | Application Type | Generic Application | | Service Provider Name | `{leave blank}` | | Consumer key | `{leave blank}` | | Shared secret | `{leave blank}` | | Request Token URL | `{leave blank}` | | Access token URL | `{leave blank}` | | Authorize URL | `{leave blank}` | | Create incoming link | Check the box | 1. Fill in the next form as follows and click **Continue**. To find the public key in the [Datadog Jira integration tile](https://app.datadoghq.com/integrations/jira), click **Add Account**. | Field | Input | | ------------- | ----------------------------------------------------------- | | Consumer Key | `{Enter a key name (e.g. datadog)}` | | Consumer Name | Datadog | | Public Key | `{Enter the public key from Datadog Jira integration tile}` | #### Jira Data Center instructions{% #jira-data-center-instructions %} {% callout %} # Important note for users on the following Datadog sites: app.ddog-gov.com {% alert level="info" %} Jira Data Center's current OAuth 1.0a implementation is not FIPS 140-2 compliant. US1-FED customers should be aware of this limitation when considering the integration for FedRAMP environments. {% /alert %} {% /callout %} 1. Navigate to Jira. 1. Click the Gear icon in the right corner and select **Applications**. 1. In the left menu under **Integrations**, click **Application links**, and then click **Create link**. 1. In the **Create link** dialog, select **Atlassian product** and provide the Application URL as `https://`. Click **Continue**. 1. Ignore the warning "No response was received from the URL you entered" and click **Continue**. 1. Fill in the form using the same parameters as shown above in the Jira Cloud instructions. ### Connect Datadog to your Jira instance{% #connect-datadog-to-your-jira-instance %} {% alert level="info" %} Datadog highly recommends having a dedicated (non-personal) Jira service account specifically for this integration for optimal and more consistent results. {% /alert %} 1. Navigate to the [Datadog Jira integration tile](https://app.datadoghq.com/integrations/jira) and click **Add Account**. 1. Enter the URL of your Jira instance and the consumer key of the application link you previously created. 1. Click **Connect** and follow the instructions on the Jira authorization page. Be sure to log into this account before hitting **Connect**. **Note**: The Datadog Jira integration can connect to On-Prem/Jira Data Center instances. However, many of these instances blacklist IP ranges. For the integration to work, follow the IP filtering documentation below. ### IP filtering{% #ip-filtering %} If your Jira instance filters traffic by IP address, you need to allow connections from the **Webhooks** IP prefixes belonging to Datadog in order for the integration to work. For a list of **Webhooks** IP prefixes for your region, see [Datadog IP Ranges](https://docs.datadoghq.com/api/latest/ip-ranges/). ### Further configuration{% #further-configuration %} To configure automated Jira issue creation with bidirectional syncing in Case Management, see the instructions for Configuring a Jira webhook and the [Case Management](https://docs.datadoghq.com/service_management/case_management/settings/#jira) documentation. To create Jira issues from Datadog monitor alerts, see Configure an issue template. ## Configure a Jira webhook{% #configure-a-jira-webhook %} Configuring a webhook enables cases created in Case Management to automatically create issues in Jira and keep both resources synced. To create a Jira webhook: 1. In Jira, click the **Gear** icon in the top right corner and select **System**. 1. In the left menu under *Advanced*, click **Webhooks**. 1. Click **Create a Webhook** in the right corner. 1. Enter `Datadog Webhook` as the webhook name. 1. Keep the status as **Enabled**. 1. Navigate to the [Datadog Jira integration tile](https://app.datadoghq.com/account/settings#integrations/jira). 1. Under the **Case Management** tab, copy the webhook URL. 1. Navigate back to Jira and paste the webhook URL under *URL*. 1. Enable the following issue-related events. If you only want to send a subset of issue events, you can use JQL to filter them. In this example we are filtering only for projects AB and CD. 1. Enable the `deleted` project-related events. 1. Leave everything else unchecked. 1. Click the **Create** button at the bottom of the page. ## Configure an issue template{% #configure-an-issue-template %} Issue templates define how issues are created in Jira from Datadog alert events. To create an issue template: 1. In Datadog, click **New Issue Template** in the **Connect Jira to Monitor Notifications** section. 1. Enter a name for your issue template. This name, prefixed with `jira-`, becomes the handle you can use in your monitor to send notifications to (such as `jira-my-issue-template-name`). 1. Select a Jira account. 1. Select the project and issue type (such as **Story**, **Epic**, **Task**, or **Bug**). 1. A list of configurable fields appears. Enter values in the desired fields and click **Save**. ### Configure issue fields{% #configure-issue-fields %} Issue template fields define the data that is included when creating issues in Jira. For example, you can configure your template to create issues with a specific priority or a default assignee. You can use data from the alert event to populate values in the issue fields using template variables such as `${EVENT_TITLE}`. For a list of possible variables, see the [Datadog Webhooks integration](https://docs.datadoghq.com/integrations/webhooks/). ## Usage{% #usage %} #### Automatically create issues from Datadog alerts{% #automatically-create-issues-from-datadog-alerts %} To create Jira issues from Datadog alert events, enter the notification handle of one or more issue templates such as `@jira-my-issue-template` when creating a monitor in the **Notify your team** or **Say what's happening** sections. Issues are created when the monitor triggers. New issues are not created by the monitor until the monitor is resolved. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} The Jira integration does not include any metrics. ### Events{% #events %} All created Jira issues appear as events within Datadog. ### Service Checks{% #service-checks %} The Jira integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).