Create a webhook endpoint for Icinga2

Create a webhook endpoint so that Icinga2 can send automated real-time messages or information to Incident Response.

Before you begin

Role required: Responder, Manager, or Administrator

Procedure

  1. Log in to Lightstep Incident Response.
  2. On the navigation pane, select Integrations.
    Figure 1. Integrations landing page
    Integrations landing page.
  3. Click the Icinga2 integration card.
  4. On the form, fill the fields.
    Field Description
    Name Name of the integration.
    Status Status of the integration such as enabled or disabled.
    Note: You can modify this field only after the webhook is generated.
    Service Name of the service that you want to associate with the integration.

    A service represents a functional outcome like networking, payments, or HR services, that is owned by one team. You might need multiple tool integrations to monitor each technical service and receive events from those tools.
    Description Summary for the integration.
    Integration URL The URL of the home page of the monitoring tool that sends alerts.
    Tags Tags that can help users search for the integration.
  5. Click Generate Webhook.

    A webhook URL is generated. Icinga2 sends messages to this secure webhook endpoint.

    Webhook generated for Icinga2 integration.

  6. Copy the webhook URL by clicking the copy icon (Copy the webhook URL.). You will need it when configuring Icinga2.
    Note: Select 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.
  7. Click Save.

What to do next

Download the following files from the integration page:
  • Configuration file for webhook notification setup: webhook_notification_lightstep.conf
  • Python script to get alerts: lightstep-webhook