Docs » Send alert notifications to third-party services using Splunk Observability Cloud » Send alert notifications to Jira using Splunk Observability Cloud

Send alert notifications to Jira using Splunk Observability Cloud 🔗

You can configure Splunk Observability Cloud to automatically send alert notifications to Jira Cloud or Jira Server to create a new issue when a detector alert condition is met and add a comment to the issue when the alert clears.

To send Observability Cloud alert notifications to Jira, perform the following configuration tasks:

Step 1: Create a Jira integration in Observability Cloud 🔗

The alert notification that this integration sends to Jira can automatically set the following field values:

  • Assignee

  • Description

  • Issue type

  • Project

  • Reporter

  • Summary

If the Jira project you want to create issues in requires additional field values, you’ll receive an error when you save the integration.

You must be an Observability Cloud administrator to perform this task.

To create a Jira integration in Observability Cloud:

  1. In the Observability Cloud navigation menu, select Data Setup.

  2. In the CATEGORIES menu, select Notification Services.

  3. Click the Jira tile.

  4. Click New Integration to display the configuration options.

  5. By default, the name of the integration is JIRA. Splunk recommends that you give your integration a unique and descriptive name. For information about the downstream use of this name, see About naming your integrations.

  6. In the JIRA Base URL field, enter the Jira server base URL. For example, enter a value that looks something like this : https://YOUR-DOMAIN.atlassian.net or http://YOUR-HOSTNAME:PORT.

  7. If you want to create an integration with Jira Cloud, click JIRA Cloud and enter a Jira user email address and API token. For information about how to create an Atlassian API token, see Manage API tokens for your Atlassian account.

    If you want to create an integration with Jira server, click JIRA Server and enter a Jira username and password.

    The user you associate with this integration must have Jira permissions to create issues, add comments, and browse projects. This user will be the reporter on the Jira issues created by using this integration.

  8. Click Select Project, select the project you want the alert notifications to create issues in, and click Apply.

  9. Click Select Issue Type, select the issue type you want the alert notifications to create, and click Apply.

    If necessary, you can create multiple integrations using other issue types. For example, you can use one integration to create bug issues and another integration to create task issues.

  10. In the Assignee field, enter the default assignee for the issues created by this integration. If your Jira instance doesn’t require an assignee value to create issues, you can leave this field blank.

    You can override this default by selecting a different alert recipient on the detector in Step 2: Add a Jira integration as a detector alert recipient in Observability Cloud. This gives you the flexibility to set a default assignee on the integration and selectively change the assignee for some detectors.

  11. (Optional) Click Create Test Issue to test your integration. If the integration is working, it creates a test Jira issue in the selected Jira project. After a short delay, the integration makes a comment on the same issue, stating that the alert has cleared.

  12. Click Save.

Step 2: Add a Jira integration as a detector alert recipient in Observability Cloud 🔗

To add a Jira integration as a detector alert recipient in Observability Cloud:

  1. Create or edit a detector that you want to configure to send alert notifications using your Jira integration.

    For more information about working with detectors, see Create detectors to trigger alerts and Subscribe to alerts using the Detector menu.

  2. In the Alert recipients step, click Add Recipient.

  3. Select Jira and then select the name of the Jira integration you want to use to send alert notifications. This is the integration name you created in Step 1: Create a Jira integration in Observability Cloud.

  4. If you set an assignee on the Jira integration, the assignee name displays. To overwrite the assignee or a blank assignee set on the integration, click the assignee and enter a new assignee name.

  5. Activate and save the detector.

Observability Cloud will send an alert notification that will create a Jira issue whenever the detector rule condition is met. It will also add a comment to that issue when the alert condition clears.