Debug issues with Puppet runs, tasks, and plans in Puppet Enterprise

If you need to collect information on incoming connections to the pxp-agent to help debug orchestration issues with Puppet runs, tasks, and plans, enable pcp-access-logging on the pxp-agent in Puppet Enterprise.

Version and installation information

PE version: All supported

Solution

By default, the pcp-access-logging is turned off. However, this is an access log that should be turned on and should remain turned on.

To turn on logging on the pxp-agent, enable pcp-access-logging in Hiera or the PE console.

Enable in Hiera

1. Add the following to the Hiera data file for each target node. You might have to create files.

   puppet_enterprise::pxp_agent::extra_options:
   log-pcp-access: true

The location of the Hiera data file for setting per-node data is in our documentation. If you’re using Code Manager, create or edit data files in your control repo using the path given in the documentation.

2. If you are using Code Manager, deploy code.

3. On the target nodes, run puppet agent -t

Enable in the console

1. In the console, click Node groups and select the node group that you want to add configuration data to.
2. On the Configuration tab, add the class puppet_enterprise::pxp_agent. On Parameter, select extra_options. On Value, enter {"log-pcp-access":"true"} using our documentation for setting configuration data.

To debug issues with the pxp-agent, read our documentation.