Ask Your Question

How can I monitor the Puppet agent run?

asked 2013-04-09 14:51:14 -0600

ramindk gravatar image

We're starting to depend on Puppet in our infrastructure. Is there a simple way to monitor the state of Puppet agent runs?

edit retag flag offensive close merge delete

4 Answers

Sort by ยป oldest newest most voted

answered 2013-04-09 14:59:20 -0600

ramindk gravatar image

updated 2013-04-10 02:08:57 -0600

Each Puppet agent run should generate a /var/lib/puppet/state/last_run_summary.yaml file that looks something like the following.

    puppet: "2.7.21"
    config: 1365531454
    total: 0
    success: 0
    total: 0
    failure: 0
    failed_to_restart: 0
    failed: 0
    changed: 0
    out_of_sync: 0
    total: 263
    skipped: 6
    restarted: 0
    scheduled: 0
    user: 0.02537
    filebucket: 0.000382
    file: 2.221451
    config_retrieval: 8.83160305023193
    ssh_authorized_key: 0.006314
    total: 14.0908550502319
    service: 1.630493
    group: 0.001
    last_run: 1365532022
    exec: 1.339523
    package: 0.034719

Your best bet to check that this file exists, is it recent, and ... (more)

edit flag offensive delete link more


Isn't there a problem with this check if puppet crashes and leaves the lockfile in place? Then this check will forever report "OK: Puppet is still running".

stig gravatar imagestig ( 2016-05-26 09:09:43 -0600 )edit

answered 2013-04-09 15:31:13 -0600

kdoswald gravatar image

You can also use Puppet-dashboard or foreman to get a visual view of status of all the nodes.

edit flag offensive delete link more


While you could view the state of your system, I wouldn't call it monitoring unless it had some alerting component.

ramindk gravatar imageramindk ( 2013-04-10 02:53:04 -0600 )edit

answered 2013-04-10 10:59:14 -0600

reidmv gravatar image

"Monitor the state of Puppet agent runs" can be interpreted either as "the REAL-TIME state of Puppet agent runs" or as "the last reported state of Puppet agent runs across my environment." The first is harder, and more interesting.

If what you want is to monitor the current runstate of Puppet agents across your infrastructure in real-time, check out It's not well documented but it may provide the core of what you're looking for. In essence, what this thing does is publish events on a message queue as they happen on Puppet agents ... (more)

edit flag offensive delete link more


Looks interesting. Would be nice to get some some detail out of monitoring other than ok or broken after the fact. I might need to create a new question around ...(more)

ramindk gravatar imageramindk ( 2013-04-11 12:25:24 -0600 )edit

The link to progress_mq is broken, it contains the period at the end.

Spindizzy gravatar imageSpindizzy ( 2018-07-12 11:08:44 -0600 )edit

answered 2013-04-13 09:26:59 -0600

updated 2013-04-13 09:28:00 -0600

you can check report section in puppet master, So you can either use puppet-dashboard to check puppet run status or even send puppet agent run reports through mails

edit flag offensive delete link more


Hello, I'm just starting to learn puppet. I would like to get a report by mail of some details about the agents, like which one is down and maybe more. I don't need it in real time and would like to get an aggregated report once a day on all agents together. Can you explain the steps need to configure in agents and master to get this report ? Thanks, Nadav

Nadav gravatar imageNadav ( 2014-08-27 11:27:26 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools


Asked: 2013-04-09 14:51:14 -0600

Seen: 12,985 times

Last updated: Apr 13 '13