Diagnostics
      Back to home
      1. Knowledge Base
      2. General
      3. Diagnostics

      deviceTRUST debug log locations

      To assist us in troubleshooting deviceTRUST related issues you may be required by support to collect debug log information from your environment. Below is a list of deviceTRUST log file locations for each component.

      Microsoft Windows logs

      For the deviceTRUST Client Extension, Agent and Console:


      On Microsoft Windows, the deviceTRUST components log to an Event Tracing for Windows (.etl) file in the following location:
      • C:\ProgramData\deviceTRUST\Diagnostics\Logs\deviceTRUST-Log-xx.etl
        • This file can be copied and provided to Support

      Logging is enabled by default. Log files are cyclic and will overwrite when their max size is reached. It is therefore important that the log file is captured shortly after reproduction of an issue. The default etl log file size is 1GB.

      Windows component installer logs

      For the deviceTRUST Client Extension:


      The deviceTRUST Client Extension installer executable logs installation activity to the following location:

      %AppData%\Local\Temp
      • deviceTRUST_Client_Extension_v23.1_20250113094950.log
      • deviceTRUST_Client_Extension_v23.1_20250113094950_dtclient_extension_x64.msi.log
      • deviceTRUST_Client_Extension_v23.1_20250113094950_dtclient_extension_x86.msi.log
        • These files can be copied and provided to Support

      For the deviceTRUST Agent and Console:

      When troubleshooting installation issues for the deviceTRUST Agent or Console, MSI logs can be generated with msiexec.

      For example, from an elevated CMD prompt run the commands below to create an MSI log file capturing the install activity. The MSI and location information should be customised to your environment.

      • msiexec /i "dtagent-x64-release-23.1.410.0.msi" /l*v "C:\Temp\Agent.log"
      • msiexec /i "dtconsole-x64-release-23.1.410.0.msi" /l*v "C:\Temp\Console.log"
        • These files can be copied and provided to Support

      deviceTRUST Windows Event Logs

      For the deviceTRUST Agent:


      The Event logs are available on any computer where the Agent is installed. The event logs can be exported from Event Viewer.

      Open Event Viewer as an admin user and browse

      • Application and Services Logs > deviceTRUST > Admin 
      • Right Click on Admin and 'Save All Events As'
      • This will export the deviceTRUST Events to an .evtx file which can be provided to Support

      Linux logs

      For the deviceTRUST Client Extension:


      On Linux, the deviceTRUST client components log activity to the following location.

      • /tmp/dtclient.log 
        • This file can be copied and provided to Support

      NOTE: On IGEL OS 12 deviceTRUST Client logging is disabled by default as requested by IGEL. If required logging can be enabled via the local Setup application or within the UMS.

      Apple macOS logs

      For the deviceTRUST Client Extension:


      On Apple macOS, the deviceTRUST client components log activity to the following location.

      • /tmp/dtclient.log
        • This file can be copied and provided to Support

      Apple iOS logs

      For the deviceTRUST Client Extension:


      On Apple iOS, the deviceTRUST client component logs can be shared from within the deviceTRUST App under

      • Settings > Diagnostics
        • 'Share log files' option - Allows the user to transmit deviceTRUST logs using Apple tools e.g Mail, Air Drop
        • 'Send a support email' option - If a Mail profile is configured on the iOS device, this option will auto construct an email for the user addressed to support@devicetrust.com with the deviceTRUST log files attached. The user can fill out the email with their issue statement prior to sending.

      Export of deviceTRUST policy configuration

      For the deviceTRUST Console:


      The Policy configuration can exported from the 'Sharing' menu in deviceTRUST Console.

      • Open the deviceTRUST Console > Sharing > Export to Disk.
      • A save dialogue box will allow the user to save the .dtpol policy file to their preferred location. 
      • Example policy file '2025-01-17_10-33_deviceTRUST_Policy.dtpol'
        • The policy can be copied and provided to Support

      Amazon WorkSpaces logging

      When troubleshooting deviceTRUST Virtual Channel issues on Amazon WorkSpace, in conjunction with deviceTRUST debug log information we also require Level 3 logs to be enabled on the Amazon WorkSpace and for the connecting Amazon WorkSpace client.

      The verbosity level of these logs are required to assist deviceTRUST in troubleshooting issues, this is the minimum log level expected by Amazon Support if an issue is referred.

       

      To enable these logging options please see refer to the Amazon Documentation using the links below.


       Amazon Workspace Client Advanced options
       Amazon Workspace Advanced options