Skip to main content

Collectd Plugin to Monitor Puppet Agents

Project description


TypesDB "/usr/share/collectd/puppet_types.db"
<LoadPlugin python>
  Globals true

<Plugin "python">
  LogTraces true
  Interactive false
  Import "puppet"
  PATH "/opt/puppetlabs/puppet/cache/state/last_run_summary.yaml"
  MaxRetention 21600

The MaxRetention setting represents, in seconds, for how long the value of the metrics will be retained if there’s no fresh data to publish during the Collectd loop. Be aware that this setting depends on the global Timeout. For instance, if you want a retention of 6 hours and the Collectd timeout is set to 2 then you’ll have to halve value and set it to (6*60*60)/2.

Generated data

The plugin parses /opt/puppetlabs/puppet/cache/state/last_run_summary.yaml and reports several single values extracted from there.

It will only send data if there has been a Puppet run after the last time Collectd polled. This is monitored using a state file located in /var/lib/collectd/puppet.state. To force a data point just delete it.

These are the values that are currently being dispatched:

  • puppet/boolean-compiled (flag denoting if the catalog compiled (1 or 0))
  • puppet/seconds-config_retrieval
  • puppet/seconds-total_time
  • puppet/resources-changed
  • puppet/resources-corrective_change
  • puppet/resources-failed
  • puppet/resources-failed_to_restart
  • puppet/resources-out_of_sync
  • puppet/resources-restarted
  • puppet/resources-scheduled
  • puppet/resources-skipped
  • puppet/resources-total
  • puppet/time_ref-last_run (epoch of last puppet run (seconds))


Steve Traylen <> Nacho Barrientos <>


Apache-II License

Development notes

Don’t forget to bump the schema_version if you modify the data format.

Project details

Download files

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

Files for collectd-puppet, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size collectd_puppet-2.0.0.tar.gz (8.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page