---
title: ''
description: Telegraf plugin for collecting metrics from Puppet Agent
url: https://docs.influxdata.com/telegraf/v1/input-plugins/puppetagent/
estimated_tokens: 874
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/puppetagent/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v0.2.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/puppetagent/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/puppetagent/sample.conf)

# Puppet Agent Input Plugin

This plugin gathers metrics of a [Puppet agent](https://www.puppet.com/) by parsing variables
from the local last-run-summary file.

**Introduced in:** Telegraf v0.2.0**Tags:** system**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Reads last_run_summary.yaml file and converts to measurements
[[inputs.puppetagent]]
  ## Location of puppet last run summary file
  location = "/var/lib/puppet/state/last_run_summary.yaml"
```

## Metrics

### PuppetAgent int64 measurements

Meta:

* units: int64
* tags: ``

Measurement names:

* puppetagent\_changes\_total
* puppetagent\_events\_failure
* puppetagent\_events\_total
* puppetagent\_events\_success
* puppetagent\_resources\_changed
* puppetagent\_resources\_corrective\_change
* puppetagent\_resources\_failed
* puppetagent\_resources\_failedtorestart
* puppetagent\_resources\_outofsync
* puppetagent\_resources\_restarted
* puppetagent\_resources\_scheduled
* puppetagent\_resources\_skipped
* puppetagent\_resources\_total
* puppetagent\_time\_service
* puppetagent\_time\_lastrun
* puppetagent\_version\_config

### PuppetAgent float64 measurements

Meta:

* units: float64
* tags: ``

Measurement names:

* puppetagent\_time\_anchor
* puppetagent\_time\_catalogapplication
* puppetagent\_time\_configretrieval
* puppetagent\_time\_convertcatalog
* puppetagent\_time\_cron
* puppetagent\_time\_exec
* puppetagent\_time\_factgeneration
* puppetagent\_time\_file
* puppetagent\_time\_filebucket
* puppetagent\_time\_group
* puppetagent\_time\_lastrun
* puppetagent\_time\_noderetrieval
* puppetagent\_time\_notify
* puppetagent\_time\_package
* puppetagent\_time\_pluginsync
* puppetagent\_time\_schedule
* puppetagent\_time\_sshauthorizedkey
* puppetagent\_time\_total
* puppetagent\_time\_transactionevaluation
* puppetagent\_time\_user
* puppetagent\_version\_config

### PuppetAgent string measurements

Meta:

* units: string
* tags: ``

Measurement names:

* puppetagent\_version\_puppet

## Example Output

```text
puppetagent,location=last_run_summary.yaml changes_total=0i,events_failure=0i,events_noop=0i,events_success=0i,events_total=0i,resources_changed=0i,resources_correctivechange=0i,resources_failed=0i,resources_failedtorestart=0i,resources_outofsync=0i,resources_restarted=0i,resources_scheduled=0i,resources_skipped=0i,resources_total=109i,time_anchor=0.000555,time_catalogapplication=0.010555,time_configretrieval=4.75567007064819,time_convertcatalog=1.3,time_cron=0.000584,time_exec=0.508123,time_factgeneration=0.34,time_file=0.441472,time_filebucket=0.000353,time_group=0,time_lastrun=1444936531i,time_noderetrieval=1.235,time_notify=0.00035,time_package=1.325788,time_pluginsync=0.325788,time_schedule=0.001123,time_service=1.807795,time_sshauthorizedkey=0.000764,time_total=8.85354707064819,time_transactionevaluation=4.69765,time_user=0.004331,version_configstring="environment:d6018ce",version_puppet="3.7.5" 1747757240432097335
```