Skip to main content

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

Project description

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

Join the chat #alignak on freenode.net License AGPL v3

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.

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_monitoring-1.0.0.tar.gz (20.4 kB view hashes)

Uploaded Source

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