Compartir a través de

Archivo de mensaje de resumen

  • Artículo

Un archivo de mensaje de resumen es un archivo de texto que contiene la información sobre un seguimiento de software. Tracefmt crea un archivo de mensaje de resumen (.sum) después de procesar los mensajes en un registro de seguimiento o una sesión de seguimiento.

El archivo de mensaje de resumen incluye los siguientes datos en un resumen estadístico:

  • Número de búferes procesados

  • Número de mensajes procesados y perdidos

  • Tiempo transcurrido, en microsegundos, de la sesión de seguimiento

Después del resumen estadístico es una tabla que se compone de una fila para cada mensaje de seguimiento que se representa en el seguimiento. Cada columna de la tabla proporciona la siguiente información sobre el mensaje de seguimiento:

EventCount
Número de instancias del mensaje de seguimiento en el seguimiento.

Eventname
Nombre descriptivo del GUID del mensaje de los mensajes de seguimiento. De forma predeterminada, el nombre descriptivo de un GUID de mensaje es el nombre del directorio en el que se creó el proveedor de seguimiento, pero puede especificar un nombre descriptivo alternativo mediante el parámetro -p para RUN_WPP o Tracewpp.exe. Para obtener información, vea Opciones de Run_WPP. (EventName tiene el mismo valor que la variable %1 en el prefijo del mensaje de seguimiento).

EventType
Nombre descriptivo del mensaje de seguimiento. De forma predeterminada, el nombre descriptivo de un mensaje de seguimiento es el nombre del archivo de origen y el número de línea del código que generó el mensaje de seguimiento. (EventType tiene el mismo valor que la variable %2 en el prefijo del mensaje de seguimiento).

GUID
GUID del mensaje de los mensajes de seguimiento.

En el ejemplo siguiente se muestra un archivo de mensaje de resumen para el registro de seguimiento testtrace.etl generado por Tracedrv, un controlador de ejemplo instrumentado para el seguimiento. TraceDrv, un controlador de ejemplo diseñado para el seguimiento de software, está disponible en el repositorio de ejemplos de controladores de Windows en 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|
+---------------------------------------------------------------------------------+

El resumen anterior muestra que Tracedrv genera un mensaje de encabezado y dos mensajes de seguimiento. Una instrucción DoTraceMessage genera un mensaje de seguimiento en la línea 264 y el otro lo genera una instrucción DoTraceMessage en la línea 258. En este registro de seguimiento, hay 1700 instancias del primer mensaje de seguimiento y 17 instancias del segundo mensaje de seguimiento.

El archivo de mensaje de resumen se usa principalmente para depurar el seguimiento de software y su formato está sujeto a cambios.