Debug Logs

What are debug logs?

Debug log files contain detailed technical information about the operation of a Trustgrid node. They are useful for Trustgrid support engineers to troubleshoot issues. If your node is experiencing problems, generating logs at that time may help identify the root cause.

Generating Log Files

1. The Debug Log button is located in the top right of a Node Details page.

   

2. The Debug Log dialogue will show any previously generated log files. Clicking the Fetch Newest Logs

   

   A node must be online and connected to the Trustgrid control plane to generate and publish new logs.
3. Once the node has completed compressing and uploading the logs a new entry will appear. Clicking the Download button will pull down the zip filed to your local system.

   

   Trustgrid support will have access to the same files, it is not necessary to download and send the file to the support team. Just note the time it was generated.

Log Files

There a multiple types of logs that are included in the generated zip file.

Node Appliance Log Files

Files are gathered from the following directories:

• /var/log/trustgrid - These logs are generated by the node service as part of normal operations and upgrades. These are the most commonly used by Trustgrid support.
• /var/log/unattended-upgrades - These logs are generated by the operating system during upgrades and can be useful when troubleshooting failed upgrades.
• /var/lib/trustgrid/config - These aren’t actually logs but contain the node configuration files which may be needed by support to verify the configuration has been successfully retrieved by the node from the control plane.