Get a debug log from an agent run in Puppet Enterprise

Get a debug-level log from an agent run in Puppet Enterprise to help troubleshoot issues with an agent running on Linux and Windows, issues with long agent run times, and connectivity issues with the Puppet Server.

Version and installation information

PE version: All supported

Solution

Get a debug-level log from an agent run in PE using the command line and save it to a file.

To get a log for an agent running on Linux and Windows, run:

puppet agent -t -d --trace > puppet_output.txt 2>&1

To get a log for agent run times, run:

puppet agent -t -d --evaltrace --trace > puppet_output.txt 2>&1

To get a log to troubleshoot connectivity issues with the Puppet Server, run:

puppet agent -t -d --http_debug --trace > puppet_output.txt 2>&1

Send troubleshooting information to Support

If you need help troubleshooting, attach the output of your Puppet runs to a Support ticket, making sure to remove any sensitive information.

To direct output to a file named puppet_output.txt, for example, run:

puppet agent -td --evaltrace --profile > agent_debug.txt 2>&1

The file gets generated in the directory you’re currently in, unless you specify otherwise.

To troubleshoot Puppet runs in PE by adding flags, read our documentation.

To investigate Puppet Server performance in PE, read our documentation.