Collect and View Windows Device Testing Framework (WDTF) Traces
Most device fundamentals reliability tests in Windows Hardware Lab Kit (Windows HLK) are written by using Windows Device Testing Framework (WDTF). It can be useful to collect and view WDTF traces when you troubleshoot device fundamentals test failures.
How to Collect WDTF Traces
To collect WDTF traces, you must perform the following steps:
Start a new trace collection session.
Run the test from command line and reproduce the failure. (See Reproduce the test failure by running the test from the command line)
Stop the trace collection session.
Start a WDTF trace
You can start a WDTF trace collection from the command line, as shown in the following procedure.
To start a WDTF trace from the command line
Open a command prompt by using administrative privileges.
Type the following commands:
logman create trace "autosession\WDTF" -p {6210f559-c7f7-4d2f-b674-4bc9315cecc7} 0xffffffff 0xff -o c:\WDTF_Traces\TraceFile.etl reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v LogFileMode /t REG_DWORD /d 1 /f reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v FileMax /t REG_DWORD /d 16 /f reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v MaxFileSize /t REG_DWORD /d 0 /f
Reboot the computer.
Note
For more information about trace options, see Configuring and Starting an AutoLogger Session and Logman.
Stop Collecting Traces
You can stop a WDTF trace collection from the command line, as shown in the following procedure.
To stop a WDTF trace from the command line
Open a command prompt by using administrative privileges.
Type the following commands:
logman -stop -ets WDTF logman delete "autosession\WDTF"
Reboot the computer.
Delete collected traces
Collected event trace log (.etl) files can be very large. We recommend that you copy them from the test system to another system for later analysis, and that you delete them from the test system.
How to View WDTF Traces
To view WDTF traces, you must first format the collected .etl files into text or comma-separated, variable-length (CSV) versions.
You can run Tracefmt from the command line to create the formatted log files:
To create formatted log files from the command line
Open a command prompt by using administrative privileges.
Type Tracefmt.exe -r https://msdl.microsoft.com/download/symbols <full path to ETL file> -o OutputTxtFile.txt
Type Tracefmt.exe -r https://msdl.microsoft.com/download/symbols <full path to ETL file> -csv -o OutputCsvFile.csv
You can open CSV files in Microsoft Excel; you can use the filtering features of Excel to filter collected traces, and to search for traces from certain time periods, from certain WDTF components, and other specific criteria.
Related topics
Troubleshooting Device Fundamentals Reliability Testing by using the Windows HLK