Forge Home


Retrieve node count from PuppetDB


6,154 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.2 (latest)
  • 0.1.1 (deleted)
  • 0.1.0
released Mar 10th 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'beergeek-facecount', '0.1.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add beergeek-facecount
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install beergeek-facecount --version 0.1.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



beergeek/facecount — version 0.1.2 Mar 10th 2018


Table of Contents

  1. Overview
  2. Setup - The basics of getting started with facecount
  3. Usage - Using the new action
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module


A Puppet Module providing the ability for customer to easily track their Puppet Enterprise node counts.


  • Puppet Face to retrieve the node count from PuppetDB
  • Custom fact to expose the same information in the console
  • Puppet Class to gather historical node counts to a log file


Install the module via Code Manager or r10k and then run Puppet. If you would like to gather historical node count statistics to a file, include the provided class facecount on your Puppet Enterprise Master either through Puppet Code or the Node Classifier and statistics will be collected into the file /var/log/puppetlabs/node_count.txt for you and updated every 30 minutes.

Custom fact

This module includes a custom fact to expose node counts through the Puppet Enterprise Console. Node counts are available on the Puppet Enterprise Master/Master of Masters on it's inventory page:

node count on master

This information only makes sense to display for the Puppet Master, so regular agent nodes will display the message 'Available on Puppet Master/MoM only' instead on their individual inventory pages.


Once installed and puppet has run, you will have a new action for the puppet node subcommand on the Puppet master:

puppet node count


Requires the module to be installed on your Puppet Master and run puppet at least once on the Puppet master before the command becomes available. Can normally be only run from the Puppet master due to PuppetDB library access.


Happy for PRs!