Включение и просмотр трассировок WDTF

Трассировка WDTF означает регистрацию событий, происходящих внутри объектов WDTF. Поскольку WDTF обладает обширной инструментальной поддержкой, все объекты WDTF предоставляют информацию трассировки. WDTF обрабатывает трассировку с помощью трассировки ПО WPP. Этот тип трассировки является стандартизованным форматом, который можно прочитать с помощью средств WDK, включая TraceView. В этом разделе описывается, как использовать Logman и Tracefmt для просмотра трассировок времени выполнения WDTF. В этом разделе также описывается, как программно настроить уровни трассировки WDTF.

Как собирать и сохранять трассировки WDTF

Начало сбора трассировок WDTF

1. На тестовом компьютере откройте окно командной строки с повышенными привилегиями (запуск от имени администратора) и введите следующие команды:

   logman.exe 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
   

2. Перезагрузите компьютер.

См. Logman (Logman.exe) для информации о других параметрах. Сведения о создании сезона трассировки см. в разделе "Настройка и запуск сеанса автолога".

Прекращение сбора трассировок WDTF и сохранение файлов журнала

1. Вы можете прекратить сбор трассировок WDTF и удалить сборщик данных с помощью следующих команд:

   logman.exe -stop -ets WDTF
   logman.exe delete "autosession\WDTF"
   

2. Перезагрузите компьютер.

3. Скопируйте файлы журналов с тестового компьютера на другой компьютер для последующего анализа.

   Собранные файлы журнала ETL могут быть очень большими. Для получения наилучших результатов скопируйте файлы журналов с тестового компьютера (например, c:\WDTF_Traces\TraceFile.etl) на другой компьютер. Затем можно удалить файлы журналов с тестового компьютера.

Как просматривать трассировки WDTF

Для просмотра трассировок WDTF требуется форматирование файлов ETL. Ниже показано, как использовать Tracefmt.exe для преобразования файлов ETL в текстовые или CSV-файлы.

Для просмотра трассировок WDTF

1. Например, следующая команда преобразует файл ETL, сохраненный как c:\WDTF_Traces\TraceFile.etl в текст.

   Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt
   

2. Следующая команда преобразует файл ETL, сохраненный как c:\WDTF_Traces\TraceFile.etl в разделенный запятыми файл (CSV).

   Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv
   

3. Откройте CSV-файлы в Microsoft Excel, чтобы использовать функции фильтрации Excel для фильтрации собранных трассировок. Трассировки можно отфильтровать на определенные периоды времени. Трассировки можно фильтровать, чтобы изучить трассировки, зарегистрированные определенными компонентами WDTF.

Программная настройка уровней трассировки WDTF

Все объекты WDTF предоставляют сведения трассировки в процессе работы.

WDTF предоставляет набор настраиваемых уровней TTraceLevel . Сведения о настройке TTraceLevel определенного экземпляра объекта во время выполнения см. в методе ITracing::SetTraceLevel .

Сведения о настройке TTraceLevel по умолчанию для интерфейса см. в справочнике по Платформе тестирования устройств Windows.

Подробное описание типов трассировок, включенных в каждый TTraceLevel, см. в интерфейсе ITracer . Вы можете глобально настроить эти уровни самостоятельно, используя путь TraceLevel реестра ITracer.

В следующей таблице описаны уровни трассировки, которые можно задать.

При отладке с использованием данных трассировки рекомендуется задать уровни трассировки на 1 для всех объектов, а затем задать уровни трассировки гораздо выше для объектов, которые вы изучаете.

Дополнительные сведения об уровнях трассировки см. в интерфейсе ITracer .

Связанные темы

Настройка и запуск сеанса AutoLogger
Логман
Tracefmt
TraceView
Трассировка программного обеспечения WPP