Skip to main content

Alignak checks pack for Alignak daemons

Project description

Checks pack for monitoring Alignak daemons with the Nagios monitoring check_tcp

Most recent PyPi version Join the chat #alignak on freenode.net License AGPL v3

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

Installation

The installation of this checks pack will copy some configuration files in the Alignak default configuration directory (eg. /usr/local/share/alignak/etc). 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-alignak

From source files

To install the package from the source files:

git clone https://github.com/Alignak-monitoring-contrib/alignak-checks-alignak
cd alignak-checks-alignak
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_http Nagios (or Monitoring) plugin that must be installed on the Alignak server running your poller daemon. You may install the common Nagios plugins or the alignak-checks-monitoring package (see the corresponding repo).

It is also checking information directly from the Algnak arbiter API endpoints thanks to an embedded script.

Alignak configuration

For a standard Alignak host, you simply have to tag the concerned host with the template alignak.:

# An host with all the Alignak daemons
define host{
   use                     alignak
   host_name               my_alignak
   address                 127.0.0.1
}

For a specific configuration, set the ` _satellites` host variable with the list of your configured daemons:

# An host with some specific Alignak daemons
define host{
   use                     alignak
   host_name               my_alignak
   address                 127.0.0.1

   # Default satellites is one instance of each type
   # Service generator variable:
   # - $(type)
   # - $(unique name)
   # - $(port)
   _satellites       arbiter-master$(arbiter)$$(arbiter-master)$$(10000)$,\
                     scheduler-master$(scheduler)$$(scheduler-master)$$(10001)$,\
                     scheduler-second$(scheduler)$$(scheduler-second)$$(20001)$,\
                     scheduler-third$(scheduler)$$(scheduler-third)$$(30001)$,\
                     reactionner-master$(reactionner)$$(reactionner-master)$$(10002)$,\
                     poller-master$(poller)$$(poller-master)$$(10003)$,\
                     broker-master$(broker)$$(broker-master)$$(10004)$,\
                     receiver-master$(receiver)$$(receiver-master)$$(1005)$

   _ALIGNAK_ENDPOINT   http://127.0.0.1:10000
}

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/alignak/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.

Project details


Release history Release notifications

This version

1.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for alignak-checks-alignak, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size alignak_checks_alignak-1.1.0-py2-none-any.whl (24.8 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size alignak_checks_alignak-1.1.0.tar.gz (23.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page