How to gather agent diagnostic logs (4306400)

In a recent version of the KACE Systems Management Appliance, the ability to gather diagnostic files from a connected agent was implemented directly within the WebUI. These files are often used by KACE Technical Support and can be used by any administrator to attempt to review and resolve situations at the agent level. They can be especially helpful when troubleshooting agent tasks like inventory, managed installations, scripts, patching, updates, oval scans, and more.

Note: If the target device is disconnected, it will be necessary to gather logs locally. There may also be situations where gathering a full kapture would be beneficial or necessary. Please see the Using the KACE Agent Toolkit (KAT) article for more information.

The logs collected can include:

• 'amp.conf'
• 'inventory.xml'
• 'kuid.txt'
• 'konea*.log'
• 'kagent*.log'
• 'ps_err.txt'
• 'ps_out.txt'
• 'InvColPC*'
• 'DELL_INV'
• 'konea-*.pem'
• 'agent_file_listing.txt'
• "KPATCH_DETECT_OUTPUT"
• "KPATCH_DEPLOY_OUTPUT"
• "KPATCH_ROLLBACK_OUTPUT"
• "KPATCH_PREDETECT_OUTPUT"
• "KACEPATCH_DETECT_MST"
• "KACEPATCH_DEPLOY_MST"
• "KACEPATCH_ROLLBACK_MST"
• "KPDMLST"

To gather the Agent Diagnostic Logs:

Note: If the device is disconnected, this option will not be available. Logs will be purged after 30 days. If run again, previous logs will be overwritten.

1. Go to Inventory | Devices | Click on name of specific device
2. From within Device Detail, go to Choose Action | Upload Agent Files (Diagnostic)

3. Wait for the message at the top of the page to disappear
   1. Gathering diagnostic files from the agent. This may take some time. Please wait...

4. After the message disappears, scroll down to the Logs and Diagnostics section
5. Expand the section Agent Files (Diagnostic) to reveal available logs

6. Retrieve/review logs
   1. Logs can be saved on a local device for later review

For more information on reviewing logs, see Reviewing KACE agent logs during troubleshooting (331274)