facecount

pdk
Retrieve node count from PuppetDB

beergeek

beergeek

6,073 downloads

4,574 latest version

5.0 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1
  • 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
  • Debian
    ,
    RedHat
    ,
    Ubuntu
    ,
    windows

Start using this module

Documentation

beergeek/facecount — version 0.1.2 Mar 10th 2018

facecount

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

Overview

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

Features

  • 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

Setup

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.

Usage

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

puppet node count

Limitations

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.

Development

Happy for PRs!