Nagios Integration

With the iLert Nagios Notification Plugin, you can easily integrate Nagios with iLert and extend your existing Nagios system (and other Nagios forks) with advanced alerting by SMS, phone calls, and push notifications as well as on-call schedules.
System requirements
Nagios 2 (or higher)
Python 2.7.3 (or higher)
In iLert: create Nagios alert source
1. Create a new alert source in iLert
2. From the tool integration menu, select the type Nagios and click save.
3. An API key is generated. You will need the API key below when setting up the plugin.
In Nagios: install the notification plugin
Download the iLert Nagios plugin and unzip it:
1
> https://github.com/iLert/ilert-nagios/releases/download/latest/ilert-nagios.zip
2
> unzip ilert-nagios.zip
Copied!
Put the plugin file nagios_ilert.py in the directory /usr/local/bin. The file must be executable by both Nagios and the cron daemon:
1
 > mv ilert_nagios.py /usr/local/bin > chmod 755 /usr/local/bin/ilert_nagios.py
Copied!
In Nagios, enable the macro enable_environment_macros (if not already active). Open your Nagios configuration file nagios.cfg and set the value to 1:
1
enable_environment_macros=1
Copied!
If you have a larger Nagios installation and don't want to enable the macro enable_environment_macros, see the ilert_nagios.cfg configuration file for further information on how to this.
Open the plugin configuration file ilert_nagios.cfg and enter the API key in the pager field of the contact definition, eg:
1
define contact {
2
    contact_name                    ilert
3
    alias                           iLert
4
    service_notification_period     24x7
5
    host_notification_period        24x7
6
    service_notification_options    w,u,c,r
7
    host_notification_options       d,r
8
    service_notification_commands   notify-ilert
9
    host_notification_commands      notify-ilert
10
    pager                           <YOUR-API-KEY>
11
}
Copied!
Copy the file into the Nagios configuration directory (varies depending on the Nagios installation).
1
 > cp ilert_nagios.cfg /etc/nagios/conf.d/
Copied!
Depending on the installation of Nagios, there is a nagios.cfg file in which you must integrate the iLert configuration file. The entry in nagios.cfg would look like this for this example:
1
 cfg_file=/etc/nagios/conf.d/ilert_nagios.cfg
Copied!
Add the iLert contact to your Nagios contact group. If you are using the Nagios defaults, open the contacts.cfg file for the iLert contact:
1
define contactgroup{
2
    contactgroup_name admins
3
    alias Nagios Administrators
4
    members nagiosadmin, ilert
5
}
Copied!
Edit the crontab file from the nagios user
1
 > crontab -u nagios -e
Copied!
Add the following entry:
1
 * * * * * /usr/local/bin/ilert_nagios.py -m send
Copied!
Via this cron job, events are sent to iLert every minute that failed in the first send attempt (e.g. due to a network error).
Restart Nagios:
1
 > /etc/init.d/nagios restart
Copied!
FAQ
Which Nagios Notification Types are processed by the plugin?
The plugin processes the notification types PROBLEM , ACKNOWLEDGEMENT and RECOVERY . The notification types FLAPPING* and DOWNTIME* are ignored.
What happens if my internet connection is interrupted? Are the events generated in Nagios lost?
No, events won't be lost. The plugin stores the events locally in a temporary directory (by default in /tmp/ilert_nagios) and tries to send them to iLert every minute. This means that as soon as your connection is available again, cached events will be sent to iLert. In addition, we recommend that you monitor your Internet connection using our uptime monitoring feature.
The plugin does not work. What can I do?
Please take a look at the log first. The plugin uses the Unix / Linux system log for logging (e.g. under /var/log/messages or /var/log/syslog ). If you cannot find the error, please contact our support at [email protected].

Integrations - Previous

N-central Integration

Next - Integrations

New Relic Integration

Last modified 10mo ago

Copy link

Edit on GitHub

Contents

System requirements

In iLert: create Nagios alert source

In Nagios: install the notification plugin

FAQ