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

Helper Classes for plugin development and nagios management.

Project Description

python-nagios-helpers A.K.A naghelp is a collections of classes for building nagios Active plugins. It is higly recommended to use python-textops to manipulate collected data.

Here is an exemple of an active python plugin, create a file

from naghelp import *
from textops import *

class LinuxFsFull(ActivePlugin):
    """ Basic plugin to monitor full filesystems on Linux systems"""
    cmd_params = 'user,passwd'
    tcp_ports = '22'

    def collect_data(self,data):
        data.df = Ssh(,,'df -h')

    def parse_data(self,data):
        df = data.df.skip(1)
        data.fs_critical = df.greaterequal(98,key=cuts(r'(\d+)%')).cut(col='5,4').renderitems()
        data.fs_warning = df.inrange(95,98,key=cuts(r'(\d+)%')).cut(col='5,4').renderitems()
        data.fs_ok = df.lessthan(95,key=cuts(r'(\d+)%')).cut(col='5,4').renderitems()

    def build_response(self,data):

if __name__ == '__main__':

To excute manually:

python --ip= --user=naghelp --passwd=lgpl

On error, it may return something liek this:

==================================[  STATUS  ]==================================

----( CRITICAL )----------------------------------------------------------------
/ : 98%
/home : 99%

----( WARNING )-----------------------------------------------------------------
/run/shm : 95%

----( OK )----------------------------------------------------------------------
/dev : 1%
/run : 1%
/run/lock : 0%

============================[ Plugin Informations ]=============================
Plugin name : __main__.LinuxFsFull
Description : Basic plugin to monitor full filesystems on Linux systems
Ports used : tcp = 22, udp = none
Execution time : 0:00:00.673851
Exit code : 2 (CRITICAL), __sublevel__=0

Or if no error:


============================[ Plugin Informations ]=============================
Plugin name : __main__.LinuxFsFull
Description : Basic plugin to monitor full filesystems on Linux systems
Ports used : tcp = 22, udp = none
Execution time : 0:00:00.845603
Exit code : 0 (OK), __sublevel__=0

Naghelp will automatically manage some options:

$ python -h
Usage: [options]

  -h, --help         show this help message and exit
  -v                 Verbose : display informational messages
  -d                 Debug : display debug messages
  -l FILE            Redirect logs into a file
  -i                 Display plugin description
  -n                 Must be used when the plugin is started by nagios
  -s                 Save collected data in a temporary file
  -r                 Use saved collected data (option -s)
  -a                 Collect data only and print them
  -b                 Collect and parse data only and print them

  Host attributes:
    To be used to force host attributes values

    --passwd=PASSWD  Passwd
    --ip=IP          Host IP address
    --user=USER      User
    --name=NAME      Hostname

For more information, Read The Fabulous Manual !


0.1.22 (2017-07-07)

Add Ssh run_script(), get() and put() methods

0.1.21 (2017-04-26)

Add textops.logger as managed logger

0.1.20 (2017-04-26)

moving host debug traces into load_host_data()

0.1.19 (2017-04-22)

Cache discovered plugins in find_plugins()

0.1.18 (2017-04-07)

add post and session handling in Http() class

0.1.17 (2017-04-05)

do not add logger handler more than once

0.1.16 (2017-03-27)

Now possible to instanciate a plugin with extra options

0.1.15 (2017-03-20)

Fix case where there is no docstring for a plugin

0.1.14 (2017-01-31)

Remove version limitation over sphinx package in

0.1.12 (2017-01-26)

remove unusefull code

0.1.11 (2017-01-26)

runsh* now return extended type for textops operations

0.1.10 (2016-09-05)

add collect_* options add timeout for collect_data()

0.1.9 (2016-08-26)

Map all options in host object (not only host__*)

0.1.8 (2016-08-04)

Perf data in plugin output are now space separated

0.1.7 (2016-04-14)

Add Execution date for active plugins in plugin informations section Add Update date in plugin informations for Managed hosts

0.1.6 (2016-04-12)

Add HostsManager Mixin Add collect.Http class Create Lockfile utility move Timeout utility in

0.1.5 (2016-03-23)

Add Gauges Mixin Add docs Many other improvements

0.1.4 (2016-03-08)

Better error management

0.1.3 (2016-01-13)

Add docs

0.1.1 (2016-01-08)

Add a launcher

0.1.0 (2015-12-17)

Add some docs, tests Tune some functions

0.0.7 (2015-11-19)

First working version

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


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
python-nagios-helpers-0.1.22.tar.gz (66.7 kB) Copy SHA256 Checksum SHA256 Source Jul 10, 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