Arquivo de Mensagem de Resumo

  • Artigo

Um arquivo de mensagem de resumo é um arquivo de texto que contém as informações sobre um rastreamento de software. Tracefmt cria um arquivo de mensagem de resumo (.sum) depois de processar as mensagens em um log de rastreamento ou sessão de rastreamento.

O arquivo de mensagem de resumo inclui os seguintes dados em um resumo estatístico:

  • O número de buffers processados

  • O número de mensagens processadas e perdidas

  • O tempo decorrido, em microssegundos, da sessão de rastreamento

Seguindo o resumo estatístico está uma tabela composta por uma linha para cada mensagem de rastreamento representada no rastreamento. Cada coluna da tabela fornece as seguintes informações sobre a mensagem de rastreamento:

EventCount
O número de instâncias da mensagem de rastreamento no rastreamento.

Eventname
O nome amigável do GUID da mensagem das mensagens de rastreamento. Por padrão, o nome amigável de um GUID de mensagem é o nome do diretório no qual o provedor de rastreamento foi criado, mas você pode especificar um nome amigável alternativo usando o parâmetro -p para RUN_WPP ou Tracewpp.exe. Para obter informações, consulte Opções de Run_WPP. (EventName tem o mesmo valor que a variável %1 no prefixo da mensagem de rastreamento.)

Eventtype
O nome amigável da mensagem de rastreamento. Por padrão, o nome amigável de uma mensagem de rastreamento é o nome do arquivo de origem e o número de linha do código que gerou a mensagem de rastreamento. (EventType tem o mesmo valor que a variável %2 no prefixo da mensagem de rastreamento.)

GUID
O GUID da mensagem das mensagens de rastreamento.

O exemplo a seguir mostra um arquivo de mensagem de resumo para o log de rastreamento testtrace.etl gerado pelo Tracedrv, um driver de exemplo instrumentado para rastreamento. TraceDrv, um driver de exemplo que foi projetado para rastreamento de software, está disponível no repositório de exemplos de driver do Windows no 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|
+---------------------------------------------------------------------------------+

O resumo anterior mostra que Tracedrv gera uma mensagem de cabeçalho e duas mensagens de rastreamento. Uma mensagem de rastreamento é gerada por uma instrução DoTraceMessage na linha 264 e a outra é gerada por uma instrução DoTraceMessage na linha 258. Neste log de rastreamento, há 1700 instâncias da primeira mensagem de rastreamento e 17 instâncias da segunda mensagem de rastreamento.

O arquivo de mensagem de resumo é usado principalmente para depurar o rastreamento de software e seu formato está sujeito a alterações.