Create a webhook endpoint for Lightstep Observability
You can also create a custom webhook integration with Lightstep Observability by generating a webhook URL in LIR and configuring it in Lightstep Observability.
Before you begin
Role required: Responder, Manager, or Administrator
Procedure
- Log in to Lightstep Incident Response.
-
On the navigation pane, select Integrations.
- Click the Lightstep Observability integration card.
- Enter the name of the integration in the Name field.
-
The Status field shows the status of the integration
such as enabled or disabled.
Note: You can modify this field only after the webhook is generated.
-
Select the service that you want to associate with the integration. You have
two options:
- (Option 1) Specify the service path in the JSON alert payload, so that
Lightstep Observability can send alerts on behalf of various services
without having to create a separate webhook for each service.
- Select the Service defined in payload? check box.
- To associate the alert to the service that is defined in the alert
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 alert is assigned to it.
- If the service name doesn't exist, then a new service is created and the alert is assigned to this service.
- The alert is assigned to the default service selected in
the Service field if:
- The JSON path specified for the service doesn't exist in the alert payload.
- The JSON path for the service exists, but there's no value given for it in the alert payload.
- You've crossed your subscription limit.
- Lightstep Observability supports multiple alerts in a single payload, in the form of alert arrays. In this case, you can provide the array path for the service. For example, alerts[3].labels.alertname.
For example, if the JSON alert payload contains
and the JSON path is labels.service_name, then Incident Response will assign the alert to the Shopping Cart service.{ … "labels":{ "service_name":"Shopping Cart", … } … }
- (Option 2) Select a single service so that Lightstep Observability
alerts will always be associated with that service.
- Leave the Service defined in payload? check box deselected.
- Select a service in the Service field.
- (Option 1) Specify the service path in the JSON alert payload, so that
Lightstep Observability can send alerts on behalf of various services
without having to create a separate webhook for each service.
- Add a description for your integration in the Description field.
- Add the URL of the home page of the monitoring tool that sends alerts in the Integration URL field.
- Add tags that can help users search for the integration using the Tags field.
-
Click Generate Webhook.
A webhook URL is generated. Lightstep Observability sends messages to this secure webhook endpoint.
-
Copy the webhook by clicking the copy icon (
). You will need it when configuring Lightstep Observability.
Note: Click Send sample alert to generate a sample alert from Incident Response and view it in Alerts. This allows you to experiment with automation rules, on-call scheduling, and escalation policies without having to set up the webhook with an external monitoring tool. - Click Save.