Поделиться через

Включение и просмотр трассировок 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.

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

Level Описание
0 Выкл. Трассировка не предоставляется.
1 Низкий
2 Средняя. Этот уровень является уровнем трассировки по умолчанию.
3 Высокий
4 Полного восстановления. Отображаются все сведения трассировки.
5-8 Пользовательские уровни.
9 Возвращает объекту начальный уровень трассировки.

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

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

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