Skip to main content

Class library for writing Nagios (Icinga) plugins

Project description

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.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nagiosplugin-0.4.5.tar.gz (26.0 kB) Copy SHA256 hash SHA256 Source None Jun 18, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page