Python-based Icinga Plugins Collection

This Enterprise Class Plugin Collection provides various Python 2 based check plugins for Nagios and compatible monitoring systems like Icinga, Shinken, Centreon or Sensu. All checks are tested on CentOS 7+ (Minimal), Fedora 30+ and Ubuntu Server 16+.

If you

• are disappointed by nagios-plugins-all
• search for checks that are all written in Python2 only (your system language on CentOS)
• want to have an easy look into the source code of the checks
• want to use checks that are fast, reliable and mainly focused on CentOS and Icinga2
• want to use checks that all behave uniform and report the same (for example "used") in a short and precise manner
• want to use checks out of the box with some kind of auto-discovery, that use useful defaults and only throw CRITs where it is absolutely necessary
• are happy about checks that provide some additional information to help you troubleshoot your system
• want to use plugins that try to avoid 3rd party dependencies wherever possible

... then these checks might be for you.

Python2

All checks are written in Python 2, because ...

• in a datacenter environment (where these checks are mainly used) the python == python2 side is still more popular.
• in CentOS 7, Python 2.7 is the default (Python3 became available in CentOS 7.8).
• in CentOS 8, there is no default. You just need to specify whether you want Python 3 or 2.
• support for Python 2 has ended, but not in CentOS 8 (Python 2 remains available in CentOS 8 until the late 2020's decade - for further details have a look at https://developers.redhat.com/blog/2018/11/14/python-in-rhel-8/).

Our checks call Python 2 by using #!/usr/bin/env python2.

Python3

Providing a Python 3 variant of each check is on our roadmap.

Libraries

We try to avoid dependencies on 3rd party libraries wherever possible. If we have to use additional libraries for various reasons, we stick on official versions. Have a look at the plugin README or at the Check Plugin Fact Sheet at the end of this document.

Of course we make use of our own libraries, which you simply have to copy from our lib-linux GitLab repo to the plugins lib directory (mostly /usr/lib64/nagios/plugins/lib).

So this is how your check plugin directory should look like:

$ tree /usr/lib64/nagios/plugins/

/usr/lib64/nagios/plugins/
|-- about-me
|-- ...
|-- lib
|   |-- globals.py
|   |-- ...
|   |-- ...
|-- ...

Running a Check

What you need:

CentOS 8

• Required: Install Python2, for example by using dnf install python2
• After that, most of the checks will run out of the box.
• Optional: Install 3rd party Python modules if a check requires them. Some of those modules are found in the EPEL repo. Example: dnf install epel-release; dnf install python2-psutil

CentOS 7

• Most of the checks will run out of the box.
• Optional: Install 3rd party Python modules if a check requires them. Some of those modules are found in the EPEL repo. Example: yum install epel-release; yum install python2-psutil

Fedora

• Required: Install Python2, for example by using dnf install python2
• After that, most of the checks will run out of the box.
• Optional: Install 3rd party Python modules if a check requires them. Example: dnf install python2-psutil

Ubuntu 20

• Most of the checks will run out of the box.
• Optional: Install 3rd party Python modules if a check requires them. Example: apt install python-psutil

Ubuntu 16

• Required: Install Python2, for example by using apt install python-minimal
• After that, most of the checks will run out of the box.
• Optional: Install 3rd party Python modules if a check requires them. Example: apt install python-psutil

Reporting Issues

For now, there are two ways:

1. Send an email to info[at]linuxfabrik[dot]ch, describing your problem
2. Create an account on https://git.linuxfabrik.ch and submit an issue

Check Plugin Fact Sheet

2020052602