Основные понятия TraceView

В этом разделе описываются основные понятия, используемые в TraceView.

Сведения о понятиях, общих для средств трассировки в WDK, см. в разделе Основные понятия средств трассировки.

Группа сеансов трассировки

TraceView позволяет объединять отображение журналов трассировки или сеансы трассировки в режиме реального времени в группу сеансов трассировки и управлять ими так, как если бы они были одним сеансом. Если журналы или сеансы трассировки находятся в одной группе сеансов трассировки, их сообщения объединяются в один список сообщений трассировки.

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

Сведения о создании групп сеансов трассировки см. в разделе Группирование сеансов трассировки.

Рабочей области

В TraceView рабочая область — это набор свойств сеанса трассировки и свойств отображения журнала трассировки, которые можно сохранять и использовать повторно. В рабочих областях можно отобразить часто используемый журнал или запустить тщательно настроенный сеанс трассировки за один быстрый шаг.

Рабочая область включает:

• Все свойства сеанса трассировки, включая буферы, флаги и уровень, а также расположение журнала трассировки

• Расположение файла символов базы данных программы (PDB), файлаформата сообщений трассировки (TMF) или пути поиска TMF

• Путь и имена файлов файла описания TraceView и файла сводки

• Фильтры

При открытии рабочей области для сеанса трассировки в режиме реального времени TraceView запускает новый сеанс трассировки с сохраненными свойствами и параметрами конфигурации. При открытии рабочей области для отображения журнала трассировки журнал отображается точно так же, как вы настроили.

Дополнительные сведения см. в разделе Использование рабочих областей TraceView.

Указание поставщиков трассировки

Чтобы создать сеанс трассировки, необходимо определить поставщиков трассировки и найти инструкции по форматированию для двоичных сообщений трассировки, создаваемых поставщиками. Это можно сделать одним из следующих способов:

• Найдите исполняемый двоичный файл для исходного кода, который выстраив поставщики. TraceView может извлекать все сведения, необходимые для включения и форматирования TraceLogging и манифестированных событий ETW. Он также попытается найти файл символов PDB для включения любых поставщиков трассировки программного обеспечения WPP .

• Найдите файл символов PDB для исходного кода, включающего поставщиков трассировки программного обеспечения WPP . TraceView может извлекать из PDB-файла все сведения, необходимые для идентификации поставщиков и форматирования их сообщений трассировки.

• Найдите файл GUID элемента управления (CTL) для поставщика и укажите TMF-файл или путь к каталогу, в котором хранятся файлы TMF.

• Введите GUID элемента управления поставщика и укажите TMF-файл или путь к каталогу, в котором хранятся файлы TMF.

  Если ввести имя поставщика перед звездочкой (например *SampleProvider, ), TraceView автоматически преобразует это имя в GUID с помощью стандартного алгоритма. Не все поставщики следуют этому стандарту, но многие, например поставщики, написанные с помощью . Класс EventSource NET, сделайте.

• Выберите зарегистрированного поставщика из списка, который собирает TraceView, и укажите файл TMF или путь к каталогу, в котором хранятся файлы TMF.

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

Настройка пути поиска TMF и выбор параметров файлов TMF

При включении поставщиков WPP, если у вас нет PDB-файла символов для поставщика, необходимо указать каталог, в котором TraceView может найти TMF-файлы, или найти TMF-файлы для сообщений трассировки поставщика.

TraceView поддерживает два метода:

• Используйте параметр Задать путь поиска TMF , если вы не уверены, какие файлы TMF следует использовать для поставщика трассировки. TraceView выполняет поиск всех файлов TMF в указанном каталоге и сопоставляет GUID создаваемого сообщения с именем TMF-файла. Файлы TMF должны находиться в указанном каталоге. TraceView не выполняет рекурсивный поиск.

• Используйте параметр Выбрать файлы TMF , если вы знаете, какой файл TMF следует использовать для поставщика трассировки, или когда нужные файлы TMF находятся в разных каталогах. Этот параметр также необходимо использовать, если имя TMF-файла не является GUID сообщения, так как TraceView не может найти его в каталоге.

Если указанные TMF-файлы или файлы, которые TraceView находит в указанном каталоге, не соответствуют сообщениям трассировки, созданным поставщиком трассировки, TraceView не сможет отформатировать сообщения. Вместо этого отображается GUID сообщения трассировки и следующее сообщение об ошибке:

No Format Information found.

Чтобы создать файлы TMF из файла символов PDB, в окне командной строки используйте Tracepdb.