Enable and view the PuppetDB performance dashboard for Puppet Enterprise

Using the following steps to enable and view the PuppetDB performance dashboard will help you adjust the Java heap size. The performance console shows performance information and metrics, including JVM heap size, memory use, queue depth, command processing metrics, duplication rate, and query stats. It displays the min/max/median of each metric over a configurable duration, as well as an animated SVG sparkline (a simple line chart).

Version and installation information

PE version: All supported versions

Solution

Note: If you enable cleartext HTTP with the following steps, you must configure your firewall to protect unverified access to PuppetDB. Unencrypted HTTP is the only way to view the performance dashboard, since PuppetDB uses host verification for SSL.

To enable and view the performance dashboard:

1. Log into the console.

2. Select Node groups.

3. Select the PE PuppetDB node group.

4. Click the Classes tab.

5. Locate the puppet_enterprise::profile::puppetdb class, from the parameters drop-down list, select listen_address, and update the value to 0.0.0.0.

   Note: setting the listen_address to 0.0.0.0 allows all IP addresses to access the PuppetDB performance console.

6. Click Add parameter, and click the Commit changes button.

7. Log into your PuppetDB node as root. (On a monolithic installation, PuppetDB is on the master.)

8. Run puppet agent -t.

9. View the performance dashboard by navigating to http://<PuppetDB IP address>:<port>, replacing <PuppetDB IP address> with the IP address and <port> with the port of your PuppetDB node (8080 by default).

To disable the performance dashboard:

1. Log into the console.

2. Select Nodes groups.

3. Select the PE PuppetDB node group.

4. Click the Classes tab.

5. Locate the puppet_enterprise::profile::puppetdb class. Next to listen_address click Remove.

6. Click Commit changes.