Cookies disclaimer

I agree Our site saves small pieces of text information (cookies) on your device in order to deliver better content and for statistical purposes. You can disable the usage of cookies by changing the settings of your browser. By browsing our website without changing the browser settings you grant us permission to store that information on your device.


Integration into Icinga2

Icinga 2 is an open source monitoring system which checks the availability of your network resources, notifies users of outages, and generates performance data for reporting. Scalable and extensible, Icinga 2 can monitor large, complex environments across multiple locations.


For this chapter you need to have:


Download a configuration from our site into the directory /etc/icinga2/. E.g.:

ssh root@icinga2
root@icinga2:~# cd /etc/icinga2/
root@icinga2:/etc/icinga2# curl
root@icinga2:/etc/icinga2# tar xf escalert_icinga2.tgz

Then prepare a queue for storing messages to

mkdir /var/spool/escalert
chown nagios: /var/spool/escalert/
chmod 755 /var/spool/escalert/

Finally, you can enable a cron job to check, if messages have been queued for delivery:

root@icinga2:~# crontab -e

Enter the following line into the editor, save and quit:

# m h  dom mon dow   command
*   *   *   *   *    /etc/icinga2/scripts/

Congratulations! You have now finished the basic configuration and can now link your hosts and services from Icinga2 to your notification schemes!


In order to enable notifications for a host in Icinga2, you need to add the following configuration line to the host. E.g., this host can be found in the file hosts.conf:

Note to take the API-Key from the appropriate service in your configuration.

object Host NodeName {
  import "generic-host"

  /* other stuff */

  vars.escalert_api = "kmswlkjrqwfvs...."

In order to enable a service with the power of, use the following notation in, e.g., services.conf:

apply Service "SomeServiceName" {

  /* whatever */

  vars.escalert_api = "ppseplipowgyrkx...."

Remember to activate your changes by:

root@icinga2:~# service icinga2 checkconfig
root@icinga2:~# service icinga2 restart