Configure delegation of Jira issues to Incident Response

Create a webhook URL in Incident Response and configure it in Jira.

Before you begin

Role required: Responder, Manager, or Administrator

Administrator role in Jira

About this task

Note: While this integration with a third-party product is supported, the documentation here is based upon information provided by that third-party. More current information about the operation of that third-party’s system may be available from them directly.

Procedure

  1. Complete the steps in Configure Jira integration.
  2. Keep the Delegate Jira issues to Incident Response toggle switch on.
  3. Select the service that you want to associate with the integration. You have two options:
    • Jira assigns incidents to the service specified in the JSON payload.
      1. Select the Service defined in payload? check box.
      2. To associate the incident to the service that is defined in the payload, enter the JSON path where the service name can be found in the JSON path for the service field.
        • If this service name already exists in Incident Response, the incident is assigned to it.
        • If the service name doesn't exist in Incident Response, then a new service is created and the incident is assigned to this service.
        • If you've crossed your subscription limit, then a new service is not created. The incident is assigned to the default service selected in the Default service in case service name is not found in the payload field.
        • If the JSON path specified for the service doesn't exist in the incident payload, then the incident is assigned to the default service selected in the Default service in case service name is not found in the payload field.
        • If the JSON path for the service exists, but there's no value given for it in the incident payload, then the incident is assigned to the default service selected in the Default service in case service name is not found in the payload field.

        For example, if the JSON path is $.issue.fields.customfield_10042, Incident Response will assign the incident to the service named in the custom field 10042.

    • Jira assigns incidents to a default service in Incident Response.
      1. Leave the Service defined in payload? check box deselected.
      2. Select a service in the Service field.
      Alerts will always be assigned to the selected service.
  4. Click Save and Generate webhook.
    This generates a webhook URL.
  5. Copy the webhook by clicking the copy icon (Copy icon.).
    You will need it when configuring Jira.

    Delegate Jira issues.

    Note: If you don't want to send issues from Jira to Incident Response, turn the Delegate Jira issues to Incident Response toggle switch off.
  6. If you must change the default priority or state mappings between Jira and Incident Response, select the Field mapping tab and make the mapping changes.
    For the default mapping, see Priority and state mappings for Jira.
  7. Log in to your Jira instance.
  8. Navigate to Settings > System.
    System settings.
  9. From the navigation panel, select WebHooks.
  10. Click Create a WebHook.
    Create webhook.
  11. In the form, fill in the fields.
    Field Description
    Name Name for the webhook connection.
    Status Select Enabled.
    URL Webhook URL copied from Lightstep Incident Response.
    Description Description for the webhook connection.
    Events These events are supported currently for the Jira integration:
    • Issue related events- Comments: created, updated
    • Issue related events- Issue: created, updated
    Webhook fields.
  12. Click Create.

What to do next

Delegate issues from Jira