skip to navigation
skip to content

nagiosplugin 0.4.5

Class library for writing Nagios (Icinga) plugins

Package Documentation

Latest Version: 1.2.4

The nagiosplugin library


nagiosplugin is a class library which helps writing Nagios (or Icinga) compatible plugins easily in Python. It cares for much of the boilerplate code and default logic commonly found in Nagios checks, including:

  • Nagios 3 Plugin API compliant parameters and output formatting
  • Controller to handle the general plugin control flow
  • Full Nagios range syntax support
  • Automatic threshold checking
  • Multiple independend measures and overall state logic
  • Long output and performance data
  • Timeout handling
  • Default options
  • Persistent “cookies” to retain state information between check runs.
  • Runs on POSIX and Windows systems.

Feedback and Suggestions

nagiosplugin is primarily written and maintained by Christian Kauhaus <>. Feel free to contact the author for bugs, suggestions and patches.

A public issue tracker can be found at There is also a forum available at


The nagiosplugin package is released the Zope Public License (ZPL), a BSD-style Open Source license.


To get started writing Nagios plugins, see the examples in the examples subdirectory.

More documentation on using this package can be found in the doc directory of the source distribution. There is also an online copy of the docs available.

Release History

0.4.5 (2012-06-18)

  • Windows port. nagiosplugin code now runs under pywin32 (#10899).
  • Include examples in egg release (#9901).

0.4.4 (2011-07-18)

Bugfix release to fix issues reported by users.

  • Improve Mac OS X compatibility (#8755).
  • Include examples in distribution (#8555).

0.4.3 (2010-12-17)

  • Change __str__ representation of large numbers to avoid scientific notation.

0.4.2 (2010-10-11)

  • Packaging issues.

0.4.1 (2010-09-21)

  • Fix distribution to install correctly.
  • Documentation: tutorial and topic guides.

0.4 (2010-08-17)

  • Initial public release.
File Type Py Version Uploaded on Size
nagiosplugin-0.4.5.tar.gz (md5) Source 2012-06-18 25KB