Community projects and add-ons

None of the following projects are published by or endorsed by Puppet. They are linked to here for informational purposes only.

Jason Hancock — nagios-puppetdb

A collection of Nagios scripts/plugins for monitoring PuppetDB. These plugins get data using PuppetDB’s metrics APIs. Pulling this data into Nagios lets you monitor key metrics over time and receive alerts when they cross certain thresholds. This can partially or completely replace the built-in performance dashboard. Especially useful for knowing when the heap size or thread count needs tuning.

Erik Dalén — PuppetDB query functions for Puppet

A Puppet module with functions for querying PuppetDB data. By default, exported resources are the only way for Puppet manifests to get other nodes’ data from PuppetDB. These functions let you get other data. In particular, the pdbnodequery function can let you search nodes by class or resource, an operation that normally requires multiple PuppetDB queries. The functions in this module include:

  • pdbresourcequery
  • pdbnodequery
  • pdbfactquery
  • pdbstatusquery
  • pdbquery

Zack Smith — Puppet face for querying PuppetDB exports

A Puppet module with a face querying PuppetDB for exported resources. This simple face can be used for listing exported resources from the command line. It has support for querying all exports or filtering to a comma-separated list. Example syntax:

  • puppet node exports
  • puppet node exports file
  • puppet node exports file,user

Tim Skirvin — cms-puppetdb-tools (PuppetDB CLI tools)

A set of command-line scripts for querying PuppetDB. This was originally written for use in a specific Puppet environment, but includes a few scripts that are more generally useful. This includes:

  • puppetdb-tangled Lists “tangled” host, or where the most recent report was a success in which something changed (an event status changed), and some number of these changes have occurred several times in the last several runs (something is changing back and forth over and over again).
  • puppetdb-failed Lists hosts that failed in their last Puppet run.
  • puppetdb-tooquiet Lists hosts that have not checked in over the last two hours (configurable).

There are also a variety of tools for querying specific system facts and providing useful reports, which are tied to the upstream environment fact list.