5.3.6. HOWTO Enable Client Reporting

Puppet has the ability to send run status reports back to the server at the conclusion of each client run.

SIMP natively supports the store (default) and puppetdb report storage endpoints and can be configured as shown below.

5.3.6.1. Enable Client Reporting

Set the following in Hiera to enable client reporting:

---
pupmod::report: true

Once puppet applies this setting, clients will start sending reports to the server at the conclusion of each puppet run.

5.3.6.2. Filesystem Reports

By default, the puppet sever will enable the store reports target which will store the client reports on the local filesystem.

To view the raw reports, you can navigate to the directory output by puppet config print reportdir.

If the system has been set up for puppetdb reports and you need to change it back to store, set the following in Hiera:

---
puppetdb::master::config::manage_report_processor: true
puppetdb::master::config::enable_reports: false

5.3.6.3. PuppetDB Reports

Prior to proceeding, you should read HOWTO Enable PuppetDB if you have not already enabled puppetdb.

If you want to use a GUI application like Puppetboard to connect to puppetdb for reports, then you will need to ensure that the reports are being sent to puppetdb by the server.

To do this, set the following in Hiera:

---
puppetdb::master::config::manage_report_processor: true
puppetdb::master::config::enable_reports: true

5.3.6.4. CLI Reporting

You can use the PuppetDB API to get node reporting using curl or any other application that connect to a web endpoint and process JSON output.

SIMP provides a tool called puppetlast that can read from both the PuppetDB API as well as the locally stored YAML reports for a simple view of your environment.

The puppetlast command is provided by the simp-utils RPM.