Get optimized performance settings in Puppet Enterprise

Use the puppet infrastructure tune command when Puppet Enterprise services are generating java.lang.OutOfMemoryError errors on infrastructure hosts and/or cannot keep up with agent load. You can also use it to avoid performance issues after you make infrastructure changes such as upgrading PE, adding new compilers or replicas, or making changes to the system resources of existing hosts.

The tune command outputs settings to optimize available system resources and performance in Puppet Enterprise. You can configure the settings that tune outputs in either Hiera (preferred) or the console, but not both. Values set in the console override values set in Hiera.

Version and installation information

PE version: All supported

Solution

The puppet infrastructure tune command is compatible with most standard PE configurations. It works best for customers using a standard Puppet Enterprise installation, with all infrastructure on the primary server. If you have a very large codebase or large deployment, it might not provide the best guidance for you.

Our documentation covers how to use the tune command and its most commonly used helpful optional parameters to get your current settings and optimized settings for OS and JRuby memory.

In addition, the following optional parameter is helpful in solving performance issues that our team sees:

--estimate

Outputs a capacity summary estimating the maximum number of active nodes your infrastructure can serve, and the minimum number of JRubies needed to serve your active nodes.

Get more information about all of the available parameters by running puppet infrastructure tune --help or puppet pe tune --help