Icinga2 Integration Guide

This integration guide explains how to configure Icinga2 to send alerts to AlertAgility.

  1. First create a new service for Icinga2 Alert types. create new icinga2 type service

  2. Attach any escalation policy you want to the newly created Icinga2 Alert service. edit new icinga2 type service

  3. Download and install AlertAgility Icinga2 scripts from https://github.com/AlertAgility/alertagility-icinga2

        sudo git clone https://github.com/AlertAgility/alertagility-icinga2

  4. copy the files into Icinga2’s configuration directory.

        sudo cp alertagility-icinga2.conf /etc/icinga2/conf.d/
        sudo cp alertagility-icinga2.py /etc/icinga2/scripts/

  5. Update the subdomain and service API key in the config files so that Icinga2 sends alerts to AlertAgility’s Endpoint.

    Open the ‘/etc/icinga2/conf.d/alertagility-icinga2.conf’ file and update the ‘Pager’ field with your Alertagility service API key.

    Open the ‘/etc/icinga2/conf.d/scripts/alertagility-icinga2.py’ file and replace the ‘’ sub-string in the ‘API_URL’ field with your Alertagility subdomain.

  6. Verify and restart your Icinga2 service.

        sudo service icinga2 restart

If you encounter any issues, please jump into #alertagility IRC room and we will quickly sort out any issue.