Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Alignak - Checks pack for monitoring plugins (eg. Nagios plugins)

Project Description

Checks pack for checking a lot of services: Dns, Http, Dhcp, …

This checks pack is based upon the check plugins of the Monitoring Plugins Project.

This project is a bundle of around 50 standard plugins for monitoring applications. Some plugins allow to monitor local system metrics, others use various network protocols for remote checks.

Our bundle was previously known as the “official” Nagios Plugins package. The new name reflects both the success of the straightforward plugin interface originally invented by the Nagios folks, and the popularity of our package, as the plugins are now used with various other monitoring products as well.

Installation

The pack configuration files are to be copied to the monitoring objects configuration directory. The most suitable location is the arbiter/packs/ directory in the main alignak configuration directory.

Note: The main Alignak configuration directory is usually /usr/local/etc/alignak or /etc/alignak but it may depend upon your system and/or your installation.

The pack plugins (if any …) are to be copied to the executable libraries directories.

Note: The Alignak librairies directory is usually /usr/local/var/libexec/alignak but it may depend upon your system and/or your installation.

From PyPI

To install the package from PyPI:

sudo pip install alignak-checks-monitoring

From source files

To install the package from the source files:

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

To use this checks package, you must first install some external plugins. We recommend that you download and install the Monitoring plugins.

Check if it exists a binary package for your OS distribution rather than compiling and installing from source. Else, the source installation procedure is explained here.

An abstract:

$ wget https://www.monitoring-plugins.org/download/monitoring-plugins-2.X.tar.gz
$ gzip -dc monitoring-plugins-2.X.tar.gz | tar -xf -
$ cd monitoring-plugins-2.X
$ ./configure --prefix /usr/local/libexec/monitoring-plugins
$ make

$ make install

$ make install-root
$ # This for plugins requiring setuid (check_icmp ...)

After compilation and installation, the plugins are installed in the /usr/local/libexec/monitoring-plugins/libexec directory!

The /usr/local/etc/alignak/arbiter/packs/resource.d/monitoring.cfg file defines a global macro that contains the monitoring plugins installation path. If you do not install as default, edit this file to update the path

#-- Monitoring plugins installation directory
$MONITORING_PLUGINS_DIR$=/usr/local/libexec/monitoring-plugins/libexec
#--

Many information is available on the project github repository, espacially in the REQUIREMENTS file.

Alignak configuration

You simply have to tag the concerned hosts with the template you are interested in.

define host{
    use                     dns, ftp, http
    host_name               my_host
    address                 127.0.0.1
}

Each template declares the associated services on the concerned host. You can easily adapt the configuration defined in the templates.cfg, services.cfg and commands.cfg files.

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.

Release History

Release History

This version
History Node

1.0.0

History Node

0.3.1

History Node

0.3.0

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
alignak_checks_monitoring-1.0.0.tar.gz (20.4 kB) Copy SHA256 Checksum SHA256 Source Sep 12, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting