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


Download files

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

Source Distribution

alignak_checks_alignak-1.1.0.tar.gz (23.4 kB view hashes)

Uploaded Source

Built Distribution

alignak_checks_alignak-1.1.0-py2-none-any.whl (24.8 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page