Skip to main content
Help us improve Python packaging – donate today!

Nagios plugin to check Puppet run status through PuppetDB

Project Description


check_puppetdb_node is a Nagios / Icinga plugin that allows you to check the agent/run status by querying PuppetDB. This is more robust and reliable than parsing the report YAML that the agent might store on disk.

This plugin requires:


You can install this package from source or from PyPi.

$ pip install check_puppetdb_node
$ git clone
$ pip install .

If you wish to hack on this, clone the repository as above but instead run:

$ pip install -e .


Once you have check_puppetdb_node installed simply call the script with the --help argument for more information


We welcome contributions to this library. However, there are a few ground rules contributors should be aware of.


This project is licensed under the Apache v2.0 License. As such, your contributions, once accepted, are automatically covered by this license.

Copyright (c) 2013-2014 Daniele Sluijters

Commit messages

Write decent commit messages. Don’t use swear words and refrain from uninformative commit messages as ‘fixed typo’.

The preferred format of a commit message:

docs/quickstart: Fixed a typo in the Nodes section.

If needed, elaborate further on this commit. Feel free to write a
complete blog post here if that helps us understand what this is
all about.

Fixes #4 and resolves #2.

If you’d like a more elaborate guide on how to write and format your commit messages have a look at this post by Tim Pope.


This project does not have a test-suite but it will check for PEP-8 style violations. This is done using py.test and the pytest-pep8 plugin.



Initial release.

Release history Release notifications

This version
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
check_puppetdb_node-0.0.1.tar.gz (8.5 kB) Copy SHA256 hash SHA256 Source None Aug 8, 2014

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