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
- Complete the steps in Configure Jira integration.
- Keep the Delegate Jira issues to Incident Response toggle switch on.
-
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.
- Select the Service defined in payload? check box.
- 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.
- Leave the Service defined in payload? check box deselected.
- Select a service in the Service field.
- Jira assigns incidents to the service specified in the
JSON payload.
-
Click Save and Generate webhook.
This generates a webhook URL.
-
Copy the webhook by clicking the copy icon (
).
You will need it when configuring Jira.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. -
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.
- Log in to your Jira instance.
-
Navigate to Settings > System.
- From the navigation panel, select WebHooks.
-
Click Create a WebHook.
-
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
- Click Create.