Alignak checks package for Nginx

Checks pack for monitoring Nginx with the check_nginx script

Note: this check pack is only an example for checking nginx using the Nagios check_tcp command. Please feel free to comment or suggest improvements :)

This package uses the check_nginx_status script from this project. A version of the script is included to make installation easier but you may refresh when installing...

Installation

The installation of this checks pack will copy some configuration files in the Alignak default configuration directory (eg. /usr/local/etc/alignak). The copied files are located in the default sub-directory used for the packs (eg. arbiter/packs).

Depending upon your OS installation you may need to install some PERL dependencies:

sudo cpan install LWP

From PyPI

To install the package from PyPI:

sudo pip install alignak-checks-nginx

From source files

To install the package from the source files:

git clone https://github.com/Alignak-monitoring-contrib/alignak-checks-nginx
cd alignak-checks-nginx
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`;)

Documentation

Configuration

This checks pack is using the check_tcp Nagios (or Monitoring) plugin that must be installed on the Alignak server running your poller daemon. You may install the alignak-checks-monitoring package (see the corresponding repo).

Alignak configuration

For a Linux monitored host, you simply have to tag the concerned host with the template nginx.

# An host with an nginx instance running
define host{
    use                     nginx
    host_name               my_es
    address                 127.0.0.1
}

When using the alignak backend, use the setup.sh script provided in the json/nginx directory to include all the package information into your backend

# Backend configuration
$ json/nginx/setup.sh -b http://127.0.0.1:5000 -u admin -p admin

Note that this command line is executed when installing the package from pip. If your backend is not set locally, you can specify its address thanks to the -b command line parameter.

Bugs, issues and contributing

Contributions to this project are welcome and encouraged ... issues in the project repository are the common way to raise an information.