alignak-checks-elasticsearch 1.2.0

Alignak checks pack for Elasticsearch

Checks pack for monitoring Elasticsearch with the Nagios monitoring check_tcp

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

This package uses the check_elasticsearch 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).

From PyPI

To install the package from PyPI:

sudo pip install alignak-checks-elasticsearch

From source files

To install the package from the source files:

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

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

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

# Backend configuration
$ json/elasticsearch/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.