Configure a webhook endpoints in Nagios

Configure a webhook endpoints so that Nagios can use the endpoint to send services and host notifications to Incident Response.

Before you begin

Ensure you have installed Nagios. For information on how to install Nagios, see https://assets.nagios.com/downloads/nagioscore/docs/nagioscore/4/en/quickstart.html.

Role required: Responder, Manager, or Administrator

About this task

You need to define the payload parameters and webhook endpoint in the command definition for the integration. Every integration will have its own command definitions.
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. Log in to the console where you have installed Nagios.
  2. Click to open the Nagios server.
  3. Open the command line interface.
  4. To define the service and the host notification, open commands.cfg or the relevant commands configuration file in your system and copy and paste the command definitions from Create a webhook endpoint for Nagios.
  5. To define the contact, open contacts.cfg or the relevant contact file and paste the following code:
    define contact {
         contact_name                    lightstepteam
         alias                           Lightstep Incident Response
         service_notification_period     24x7
         host_notification_period        24x7
         service_notification_options    w,u,c,r,f
         host_notification_options       d,u,r
         service_notification_commands   notify-service-by-webhook
         host_notification_commands      notify-host-by-webhook
     }

    After you define a contact, specify the contact name in the specific service or host definitions or you can add the contact in a contact group definition in the contacts.cfg file or the relevant contact file. When a specific service or host has any issue, the contact gets notified.

  6. Verify the configuration and restart the Nagios server.
  7. Optional: To check notifications in the Nagios console, perform the following actions:
    1. Log in to the Nagios console.
    2. From the navigation pane, click Reports > Notifications.