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

Note

Some Observe instances may optionally use a name instead of Customer ID; if this is the case for your instance, contact your Observe Data Engineer to discuss implementation. A stem name will work as is, but a DNS redirect name may require client configuration.

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 source dataset associated with your Datastream 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 a worksheet

Figure 3 - Jira data in a Worksheet