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, follow these configuration steps:

Note

You must be an Observability Cloud administrator to complete these steps.

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 receive an error when you save the integration.

Note

You must be an Observability Cloud administrator to complete these tasks.

To create a Jira integration in Observability Cloud, follow these steps:

  1. Log in to Splunk Observability Cloud.

  2. Open the Jira guided setup . Optionally, you can navigate to the guided setup on your own:

    1. In the left navigation menu, select Data Management.

    2. Select Add Integration.

    3. In the integration filter menu, select All.

    4. In the Search field, search for Jira, and select it.

    5. Select New Integration to display the configuration options.

  3. By default, the name of the integration is Jira. Give your integration a unique and descriptive name. For information about the downstream use of this name, see About naming your integrations.

  4. 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.

  5. If you want to create an integration with Jira Cloud, select 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, select 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 is the reporter on the Jira issues created by using this integration.

  6. In Select Project, select the project you want the alert notifications to create issues in, and select Apply.

  7. In Select Issue Type, select the issue type you want the alert notifications to create, and select 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.

  8. 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.

  9. (Optional) Select 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.

  10. Select 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, select 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, select the assignee and enter a new assignee name.

  5. Activate and save the detector.

Splunk Observability Cloud sends an alert notification that creates a Jira issue whenever the detector rule condition is met. It also adds a comment to that issue when the alert condition clears.