Jira Tickets#

Ingest Jira ticket information using the Jira REST API and an outgoing Webhook.

To do this, you need the following items:

  • Your Jira login credentials

Note

You must have administrative access to Jira.

  • Your Observe Customer ID

  • An Observe ingest token

Configuring an Outgoing Webhook Automation Rule#

View the Jira Automation Rule documentation.

  1. Log into Jira and go to Settings > Systems > Automation Rules

  2. On the Automation Rules page, choose Create rule to display a list of triggers.

  3. Click Issue created and then Save.

  4. From the Add component page, select New action from the list. Scroll to the Notifications section and choose Send web request.

  5. Fill in the HTTP target detail:

    • Webhook URL: https://{OBSERVE_CUSTOMER}.collect.observeinc.com/v1/http/jira

    • Header name: Authorization

    • Header value: Bearer {Observe Customer ID} {Observe Ingest Token}

    • HTTP method: POST

    • Webhook body: issue data

    HTTP target values filled in

    Figure 1 - JIRA Settings

  6. Validate the webhook

Note

A valid project id must be entered to validate or Jira may return a 400.

  • Click to expand the Validate your webhook configuration section.

  • Enter an open ticket or project id to populate the test message.

  • Click Validate.

  • Confirm that you receive the HTTP/1.1 202 Accepted response.

Note

A key must be entered to validate or Jira may return a 400.

  1. Click Save to save the automation rule and webhook configuration.

    • Give your automation rule a name such as “Observe-webhook”

    • Click Turn it on to enable.

    Saving the automation rule

    Figure 2 - Adding a Component

Verify Ticket Data Ingestion#

  1. Wait for, or initiate a ticket status change.

  2. Log into Observe and open the Observation event stream in a worksheet.

  3. Open the OPAL console and apply the following filters:

    filter OBSERVATION_KIND = "http"
    filter contains(string(EXTRA.path),"jira")
    
  4. Verify ticket data exists.

    Jira data in an Observation worksheet

Figure 3 - Jira data in a Worksheet