alignak_checks_monitoring 1.1.4

From PyPI

To install the package from PyPI:

sudo pip install alignak-checks-monitoring

From source files

To install the package from the source files:

git clone https://github.com/Alignak-monitoring-contrib/alignak-checks-monitoring
cd alignak-checks-monitoring
sudo pip install .

Note: using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)

Configuration

To use this checks package, you must first install some external plugins. We recommend that you download and install the Monitoring plugins.

Check if it exists a binary package for your OS distribution rather than compiling and installing from source. Else, the source installation procedure is explained here.

An abstract:

$ wget https://www.monitoring-plugins.org/download/monitoring-plugins-2.X.tar.gz
$ gzip -dc monitoring-plugins-2.X.tar.gz | tar -xf -
$ cd monitoring-plugins-2.X
$ ./configure --prefix /usr/local/libexec/monitoring-plugins
$ make

$ sudo make install

$ sudo make install-root
$ # This for plugins requiring setuid (check_icmp ...)

After compilation and installation, the plugins are installed in the /usr/local/libexec/monitoring-plugins/libexec directory!

The /usr/local/etc/alignak/arbiter/packs/resource.d/monitoring.cfg file defines a global macro that contains the monitoring plugins installation path. If you do not install as default, edit this file to update the path:

#-- Monitoring plugins installation directory
$MONITORING_PLUGINS_DIR$=/usr/local/libexec/monitoring-plugins/libexec
#--

Many information is available on the project github repository, espacially in the REQUIREMENTS file.

Alignak configuration

You simply have to tag the concerned hosts with the template you are interested in.:

define host{
    use                     dns, ftp, http
    host_name               my_host
    address                 127.0.0.1
}

Each template declares the associated services on the concerned host. You can easily adapt the configuration defined in the templates.cfg, services.cfg and commands.cfg files.