Skip to main content

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.

Metadata

Release files for alignak-checks-alignak 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alignak-checks-alignak 1.1.0
File Size Uploaded
alignak_checks_alignak-1.1.0.tar.gz 23.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for alignak-checks-alignak 1.1.0
File Interpreter ABI Platform
alignak_checks_alignak-1.1.0-py2-none-any.whl Python 2 none any Details

Total release size: 48.2 kB

Release files / alignak_checks_alignak-1.1.0.tar.gz

Download URL alignak_checks_alignak-1.1.0.tar.gz
Size 23.4 kB
Tags Source
SHA-256 checksum
How to use checksums
69b135e5992a7b56871b0bae7cd23c49ababeeea192a4a87342a738568c75a6c
BLAKE2b-256 checksum
How to use checksums
0c79b96ec8a28f1c253464c3f4a9aa0d252d41821bcc7e5df2799d3bedeaefaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/2.7.14

Release files / alignak_checks_alignak-1.1.0-py2-none-any.whl

Download URL alignak_checks_alignak-1.1.0-py2-none-any.whl
Size 24.8 kB
Tags Python 2
SHA-256 checksum
How to use checksums
06ab380c233df3065ffea5dad1cd7bab8ccbffeb201431f8941817109011bea5
BLAKE2b-256 checksum
How to use checksums
e02fcd2ef055eb215a91b8d1470eadbf06eb50a9ebf7fcf2fae41afb4ce01cac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/2.7.14

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page