rsmuc / health_monitoring_plugins

Several plugins for icinga / nagios
GNU General Public License v2.0
16 stars 15 forks source link

health monitoring plugins:


This is the main readme file for the health montiroing plugins project. In this project we pubish all our plugins we write for icinga / nagios. The plugins are provided on pypi as python package.

All plugins are released under the GPLv2.

PyPI version

CodeFactor

Maintainability

Plugins

A detailed description can be found in the README in the doc folder.

check_jenkins_api

Monitor the jobs in the Jenkins job queue

check_local_cpu_temp

Check the local CPU temperature without the usage of "lm-sensors"

check_snmp_fortinet

Monitor Fortinet Wifi Controllers via SNMP

check_snmp_procurve

Monitor HP / Aruba procurve switches via SNMP

check_snmp_apc_ups

Monitor an UPS from APC via SNMP.

check_snmp_eaton_ups

Monitor an UPS from Eaton via SNMP. Requires the built in Eaton network card.

check_snmp_lband

Check the status of the CROSS TECHNOLOGIES redundancy controller 2082-141. Implemented against MIB 2082-141.mib

check_meinberg_ntp

Check the Meinberg NTP server LANTIME M300.

The plugin checks the current ntp and gps state, shows the current gps position and checks the good satellites. Tested with firmware version 5.30 and 6.18 (NG).

check_moxa_6000

Check the status of a Moxa NPORT 6000 RS232 to LAN converter.
You can check each port for the CTS, DSR, DTR and Error count.

check_snmp_ilo4

This plugin checks the health of HP servers with iLo 4 interface via SNMP.

check_snmp_janitza

Check the status of a Janitza 604 device.

check_snmp_large_storage

Check the used / free disk space of a device via SNMP (using the HOST-RESOURCES-MIB hrStorageSize). There are already script doing that like http://nagios.manubulon.com/snmp_storage.html . But these check script have a big problem with large storage systems.

check_snmp_port

Check the status of a tcp/udp port via SNMP. For TCP ports also the status is checked (e.g listen, established).

check_snmp_raritan

Check a Raritan Dominition PX PDU (Power Distribution Unit):

check_snmp_service

Icinga / Nagios plugin to check if a Windows service is in running state via SNMP.

check_snmp_time2

This plugin compares the time of the icinga/nagios machine with the time of a remote device.

check_snmp_idrac

This plugin checks the health of Dell iDRAC.

check_snmp_teledyne

This plugin checks the health of Teledyn Paradise Datacom Sattelite Modem.

check_snmp_ubiquiti

Check the status of a Ubiquiti airMax device.

check_microwavemodem

Check the status of a Microwave Modem

check_newtecmodem

Check the status of a Newtec Modem

check_snmp_cambium_ptp700

Check the status of a Cambium PTP 700 radio

check_snmp_eps_plus

Check the status of a ePowerSwitches (8XM+).

Installation

pip (recommended)

The complete plugin package is available at PyPI

If your Linux machine is directly connected to the internet, you can use pip to install the package. Just run:

pip install health_monitoring_plugins

The plugins will be installed in your PATH. So the scripts can be executed directly.

If you are behind a firewall or not connected to the internet, you can download the tar.hz from PyPI and install it with

health_monitoring_plugins-<version>.tar.gz

To uninstall the package you can run:

pip uninstall health_monitoring_plugins

setup.py

You can download the source package from [PyPI] (https://pypi.python.org/pypi/health_monitoring_plugins) or just clone this repository. To run setup.py you will need the python-setuptools.

To install the package from source with setup.py, you can run

tar xfvz health_monitoring_plugins-<version>.tar.gz
cd health_monitoring_plugins
python setup.py install

Run the unittests

To run the unittests just execute:

python setup.py test

The unittests require pytest. For the unittests we use the testagent from haxtibal.

Troubleshooting

When calling the plugin, I receive an error like "ImportError: No module named health_monitoring_plugins.raritan"

Seems that you did not install the python package. The plugins can not be called directly. Check the Installation section.

"Workaround:"

PYTHONPATH=~/PycharmProjects/health_monitoring_plugins/ health_monitoring_plugins/check_snmp_raritan/check_snmp_raritan.py

Roadmap

Version 0.3.0

Version 1.0.0

Changelog

Version 0.2.1
Version 0.2.0
Version 0.1.0
Version 0.0.9
Version 0.0.8
Version 0.0.7
Version 0.0.6
Version 0.0.5
Version 0.0.4
Version 0.0.3
Version 0.0.2
Version 0.0.2
Version 0.0.1