Prefijo de mensaje de seguimiento

Tracefmt agrega un prefijo a cada mensaje de seguimiento que consta de datos almacenados en el archivo de registro de seguimiento de eventos (.etl) y el archivo de formato de mensaje de seguimiento (.tmf).

Tracefmt incluye elementos de datos concretos de forma predeterminada, pero los usuarios pueden agregar y quitar elementos cambiando la variable de entorno %TRACE_FORMAT_PREFIX%, una cadena que especifica una definición de mensaje compatible con FormatMessage.

El formato del prefijo de mensaje de seguimiento predeterminado es el siguiente:

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

que genera el prefijo siguiente:

[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]

Cada variable %n representa un parámetro que se describe en la tabla siguiente.

Identificador de variable de prefijo	Tipo de variable	Descripción
%1	string	Nombre descriptivo del GUID del mensaje 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 . Para cambiar el nombre descriptivo del GUID del mensaje, use el parámetro -p con Tracewpp o con la macro RUN_WPP. Para obtener más información, vea Opciones de Run_WPP.
%2	string	Archivo de origen y número de línea. Esta variable representa el 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.
%3	ULONG	Identificador del subproceso. Identifica el subproceso que generó el mensaje de seguimiento.
%4	string	Marca de tiempo de la hora en la que se generó el mensaje de seguimiento.
%5	string	Hora del kernel. Muestra el tiempo de ejecución transcurrido para la instrucción en modo kernel, en tics de CPU, en el momento en que se generó el mensaje de seguimiento.
%6	string	Hora del usuario. Muestra el tiempo de ejecución transcurrido para la instrucción en modo de usuario, en tics de CPU, en el momento en que se generó el mensaje de seguimiento.
%7	LONG	Número de secuencia. Muestra el número de secuencia local o global del mensaje de seguimiento. Los números de secuencia local, que son únicos solo para esta sesión de seguimiento, son los predeterminados.
%8	ULONG	Id. de proceso. Identifica el proceso que generó el mensaje de seguimiento.
%9	ULONG	Número de CPU. Identifica la CPU en la que se generó el mensaje de seguimiento.
%! ¡FUNC!	string	Nombre de la función. Muestra el nombre de la función que generó el mensaje de seguimiento.
%! ¡BANDERAS!	string	Muestra el nombre de las marcas de seguimiento que habilitan el mensaje de seguimiento. (Dado que la macro DoTraceMessage invierte los argumentos flags y level, los mensajes generados por DoTraceMessage muestran el valor del nivel de seguimiento en este campo).
%! ¡NIVEL!	string	Muestra el valor del nivel de seguimiento que habilita el mensaje de seguimiento. (Dado que la macro DoTraceMessage invierte los argumentos flags y level, los mensajes generados por DoTraceMessage muestran el nombre de las marcas de seguimiento en este campo).
%! COMPNAME!	string	component_name Muestra el nombre del componente del proveedor que generó el mensaje de seguimiento. El nombre del componente solo aparece si se especifica en el código de seguimiento.
%! SUBCOMP!	string	Nombre de subcomponente. Muestra el nombre del subcomponente del proveedor que generó el mensaje de seguimiento. El nombre del componente solo aparece si se especifica en el código de seguimiento.

El símbolo dentro de signos de exclamación es un carácter de conversión que especifica el formato y la precisión de la variable. Por ejemplo, %8!04X! especifica el identificador de proceso representado como un número hexadecimal de cuatro dígitos y sin signo. Estos caracteres de conversión deben incluirse.

Para cambiar los elementos, el orden o el formato del prefijo del mensaje de seguimiento, use la variable de entorno %TRACE_FORMAT_PREFIX%. Para obtener un ejemplo, vea Ejemplo 7: Personalización del prefijo de mensaje de seguimiento.

Para obtener un ejemplo de contenido en un archivo TMF, vea Aplicar formato a los mensajes de seguimiento del ejemplo tracedrv.

Además, el parámetro -csv agrega un prefijo detallado no configurado a cada mensaje de seguimiento antes del prefijo Tracefmt estándar. Para obtener una descripción de los campos del prefijo CSV, use el parámetro -csvheader .