Configure the webhook in Icinga2
Configure webhook endpoints so that Icinga2 can use the endpoint to communicate with Incident Response.
Before you begin
Role required: Responder, Manager, or Administrator
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.
- Log in to your Icinga2 server.
- Navigate to the location where you have installed Icinga2.
Place the file
(<install location>/icinga2/conf.d).For example, in Linux, the default installation path is
On line 2, as the value for the
pagerproperty, enter the webhook URL copied from Incident Response.
- Save the changes.
- Navigate to the scripts directory in Icinga2.
Place the file
(<install location>/icinga2/scripts).For example, in Linux, the default installation path is
- Make the script executable.
Open the configuration files for hosts. Add the line
vars.enable_lightstep = trueto all the hosts for which alerts must be sent to Incident Response.
Open the configuration file for services. Add the line
vars.enable_lightstep = trueto all the services for which alerts must be sent to Incident Response.
If you want to send alerts for all hosts and all services to Incident Response, add the line
vars.enable_lightstep = trueto the generic-host and generic-service templates
(<install location>/icinga2/conf.d/templates.conf).Note: You must ensure that generic templates are being used by the host and service objects.
- Restart the Icinga2 server.
Alerts triggered in Icinga2 will create alerts in Incident Response.