Файл сводного сообщения

Файл сводного сообщения — это текстовый файл, содержащий сведения о трассировке программного обеспечения. Tracefmt создает файл сводного сообщения (SUM) после обработки сообщений в журнале трассировки или сеансе трассировки.

Файл сводного сообщения содержит следующие данные в статистической сводке:

• Количество обработанных буферов

• Количество обработанных и потерянных сообщений

• Истекшее время в микросекундах сеанса трассировки

За статистической сводкой следует таблица, состоящая из одной строки для каждого трассового сообщения. Каждый столбец таблицы содержит следующие сведения о сообщении трассировки:

EventCount
Количество экземпляров сообщения трассировки в журнале трассировки.

EventName
Понятное имя GUID сообщения трассировки. По умолчанию дружественное имя GUID сообщения — это имя каталога, в котором был создан поставщик трассировки. Однако можно указать альтернативное дружественное имя с помощью параметра -p для RUN_WPP или параметра Tracewpp.exe. Дополнительные сведения см. в разделе «Параметры Run_WPP». (EventName имеет то же значение, что и переменная %1 в префиксе сообщения трассировки.)

EventType
Удобочитаемое имя сообщения трассировки. По умолчанию понятное имя сообщения трассировки — это имя исходного файла и номер строки кода, создающего сообщение трассировки. (EventType имеет то же значение, что и переменная %2 в префиксе сообщения трассировки.)

GUID
GUID сообщений трассировки.

В следующем примере показан файл с сообщением-сводкой для журнала трассировки testtrace.etl, созданного при помощи Tracedrv, примера драйвера с инструментами для трассировки. TraceDrv, пример драйвера, разработанный для трассировки программного обеспечения, доступен в репозитории примеров драйверов Windows на сайте GitHub.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

В сводке выше показано, что Tracedrv генерирует сообщение заголовка и два трассировочных сообщения. Одно сообщение трассировки создается оператором DoTraceMessage в строке 264, а другой создается оператором DoTraceMessage в строке 258. В этом журнале трассировки есть 1700 экземпляров первого сообщения трассировки и 17 экземпляров второго сообщения трассировки.

Файл сводного сообщения используется в основном для отладки трассировки программного обеспечения, и его формат подлежит изменению.