2.1 KiB
Setting up Check Plugins
On its own Icinga 2 does not know how to check external services. The Nagios Plugins Project provides an extensive set of plugins which can be used by Icinga 2 to check whether services are working properly.
The recommended way of installing these standard plugins is to use your distribution's package manager. For your convenience here is a list of package names for some of the more popular operating systems/distributions:
| OS/Distribution | Package Name | Installation Path |
|---|---|---|
| RHEL/CentOS (EPEL) | nagios-plugins-all | /usr/lib/nagios/plugins or /usr/lib64/nagios/plugins |
| Debian | nagios-plugins | /usr/lib/nagios/plugins |
| FreeBSD | nagios-plugins | /usr/local/libexec/nagios |
| OS X (MacPorts) | nagios-plugins | /opt/local/libexec |
Depending on which directory your plugins are installed into you may need to
update the plugindir macro in your Icinga 2 configuration. This macro is used
by the service templates contained in the Icinga Template Library to determine
where to find the plugin binaries.
Integrate Additonal Plugins
You may require a custom check plugin not provided by the official Nagios plugins. All existing Nagios or Icinga 1.x plugins found on public community websites will work with Icinga 2 as well.
- MonitoringExchange
- Icinga Wiki
Once you have downloaded the plugin copy them into the directory defined by the global
IcingaMacro $plugindir$ and make sure that the user the Icinga daemon is running as
can execute the the plugin binary. Plugins should provide the --help parameter
providing details how they must get called in your command definition later on.
# cp check_snmp_int.pl /usr/local/icinga/libexec/
# chmod +x /usr/local/icinga/libexec/check_snmp_int.pl
# /usr/local/icinga/libexec/check_snmp_int.pl --help
Note
You may require additional libraries for scripts. Please consult the installation documentation and/or README for their installation requirements.