Comandos de Tracefmt

Para usar Tracefmt, escriba los comandos en una ventana del símbolo del sistema. La sintaxis siguiente muestra los elementos de un comando Tracefmt.

Para mostrar los mensajes de seguimiento en formato legible, Tracefmt debe aplicar las instrucciones de formato en un archivo de formato de mensaje de seguimiento a los mensajes de seguimiento. La sintaxis que usa depende de si tiene un archivo TMF para el proveedor de seguimiento o si desea que Tracefmt cree un archivo TMF.

Para proporcionar un archivo TMF o una ruta de acceso a un directorio de archivos TMF:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

Para crear un archivo TMF:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

Para mostrar la sintaxis en la línea de comandos.

    tracefmt -h | /?

Parámetros

EtlFile
Especifica el archivo del registro de seguimiento de eventos (.etl) que contiene los mensajes de seguimiento. Escriba la ruta de acceso (opcional) y el nombre de archivo. El valor predeterminado es c:\logfile.etl.

-Rt SessionName
Tiempo real. Da formato a los mensajes de seguimiento de las sesiones de seguimiento en tiempo real especificadas, en lugar de a partir de un registro de seguimiento.

SessionName es el nombre de la sesión de seguimiento. El valor predeterminado es el registrador de kernel nt.

-tmf TMFFile
Especifica la ruta de acceso (opcional) y el nombre de archivo de un archivo de formato de mensaje de seguimiento (.tmf) para los mensajes de seguimiento. El valor predeterminado es Default.tmf, un archivo incluido en WDK.

-Yo ImageFiles
Dirige Tracefmt para buscar los archivos de símbolos PDB de los archivos de imagen especificados y crear un archivo TMF a partir de las instrucciones de formato de los archivos PDB.

ImageFiles representa la ruta de acceso y los nombres de archivo de uno o varios archivos binarios (.exe, .dll o .sys) para los proveedores de seguimiento. Use un punto y coma (;) para separar los nombres de archivo de imagen.

-r SymbolPaths
Especifica la ubicación de los archivos de símbolos PDB privados para los archivos de imagen especificados en -i.

SymbolPaths representa una o varias rutas de acceso a directorios que almacenan símbolos privados o rutas de acceso del servidor de símbolos. Use un punto y coma (;) para separar los nombres de ruta de acceso. Los nombres de ruta de acceso de SymbolPaths pueden incluir caracteres comodín, como un asterisco (*) para representar varios caracteres y un signo de interrogación (?) para representar un solo carácter.

Si incluye -i en un comando, pero omite -r, Tracepdb busca los archivos PDB para las imágenes especificadas en las rutas de acceso especificadas por la variable de entorno %_NT_SYMBOL_PATH%. Si no se establece la variable de entorno, Tracepdb busca en la ruta de acceso de símbolo predeterminada, srv*\\\symbols\\symbols.

-p TMFPath
Especifica la ruta de acceso al directorio que almacena los archivos TMF.

Cuando se usa -p sin -i, Tracefmt busca en la ruta de acceso especificada por -p para un archivo TMF existente. Si se omite -p Tracefmt busca el archivo TMF en el valor de la variable de entorno %TRACE_FORMAT_SEARCH_PATH%, si se establece. De lo contrario, Tracefmt intenta aplicar las instrucciones de formato en el archivo Default.tmf.

Cuando se usa -p con -i, Tracefmt coloca el archivo TMF que crea en el directorio especificado por -p. Si se omite -p , Tracefmt coloca el archivo TMF en el directorio especificado por el valor de la variable de entorno %TRACE_FORMAT_SEARCH_PATH%, si se establece. De lo contrario, Tracefmt coloca el archivo en el directorio local.

-h | /?
Muestra información de ayuda.

-o OutputFile
Especifica nombres alternativos para el archivo de salida tracefmt y el archivo de mensaje de resumen de Tracefmt. Los valores predeterminados son FmfFile.txt (para el archivo de salida) y FmtSum.txt.sum (para el archivo de resumen) en el directorio local.

OutputFile es una ruta de acceso y un nombre de archivo con una extensión de nombre de archivo .txt, como c:\traces\trace.txt.

Si usa este parámetro con las opciones -displayonly o -summaryonly , solo afecta al archivo de mensaje de resumen.

-csv
Da formato al archivo de salida Tracefmt como un archivo de longitud variable (.csv) separado por comas. Este formato agrega un prefijo estructurado detallado a cada mensaje, además del prefijo de mensaje de seguimiento estándar.

Esta opción afecta al archivo de salida y a la presentación de mensajes de seguimiento en la ventana del símbolo del sistema, si existe.

-csvheader
Agrega una fila de encabezados de columna descriptivos al archivo CSV. Este encabezado es especialmente útil para interpretar el prefijo estructurado que Tracefmt agrega a los archivos CSV. De forma predeterminada, los archivos CSV tracefmt no tienen encabezados de columna.

-csvquote
Duplica todas las comillas (") del archivo CSV. Esta característica está diseñada para aplicaciones que solo muestran comillas cuando se incluyen entre comillas.

-Monitor
Muestra los mensajes de seguimiento en la ventana del símbolo del sistema, además de escribirlos en el archivo de salida.

-displayonly
Muestra los mensajes de seguimiento solo en la ventana del símbolo del sistema y no crea un archivo de salida.

-nosummary
No crea un archivo de mensaje de resumen.

-summaryonly
Crea solo un archivo de mensaje de resumen. Tracefmt no crea un archivo de salida.

-noprefix
Omite el prefijo del mensaje de seguimiento. Esta opción afecta a los mensajes de seguimiento en el archivo de salida y la presentación de Tracefmt.

-Contrata
Alta resolución. Muestra el número de microsegundos y nanosegundos en la marca de tiempo del mensaje de seguimiento. De forma predeterminada, solo se muestran milisegundos.

Use esta opción cuando se usa un valor de reloj de contador de rendimiento para la marca de tiempo del mensaje de seguimiento, en lugar del temporizador del sistema, como cuando se usa el parámetro Tracelog -UsePerfCounter . Para obtener información sobre los comandos tracelog, vea Sintaxis de comandos de Tracelog.

-Seq
Muestra los números de secuencia locales o globales en el prefijo del mensaje de seguimiento. Si los números de secuencia no se registraron en el mensaje, el campo no está inicializado o se rellena con ceros o "f".

-Ods
Envía los mensajes de seguimiento con formato al depurador para su visualización.

-Gmt
Muestra la marca de tiempo en cada mensaje de seguimiento en la hora media de Greenwich (GMT).

Esta opción afecta solo al archivo de salida tracefmt. No convierte las marcas de tiempo en el archivo de registro de seguimiento de eventos (.etl). La zona horaria del registro de seguimiento se muestra al enviar un comando Tracefmt.

-Utc
Muestra la marca de tiempo en cada mensaje de seguimiento en hora universal coordinada (UTC). UTC es casi idéntica a GMT, pero representa la medianoche como cero.

Esta opción afecta solo al archivo de salida tracefmt. No convierte las marcas de tiempo en el archivo de registro de seguimiento de eventos (.etl). La zona horaria del archivo de registro de seguimiento se muestra al enviar un comando Tracefmt.

-rastro
Muestra las acciones de Tracefmt a medida que se producen. Esta información es útil cuando el formato es incorrecto o cuando Tracefmt notifica un error o una excepción.

La visualización de seguimiento puede ser extensa. Considere la posibilidad de redirigir la salida de Tracefmt a un archivo de texto para su examen posterior.

-v
Detallado. Muestra información detallada en la ventana del símbolo del sistema, ya que Tracefmt procesa cada bloque o búfer de mensajes de seguimiento. Use esta opción cuando sospeche daños o incoherencias en el archivo.

Comentarios

Búsqueda del archivo TMF

Si omite el parámetro -i , Tracefmt usa los métodos siguientes para buscar el archivo TMF. Los métodos se enumeran en orden en que Tracefmt los usa.

• El parámetro -tmf.

• El parámetro -p.

• La variable de entorno %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, un archivo incluido en el WDK.

Si Tracefmt no encuentra un archivo TMF o el archivo TMF no incluye información de formato para los mensajes de seguimiento, Tracefmt no puede mostrar los mensajes. En su lugar, escribe el siguiente mensaje de error en lugar del mensaje de seguimiento.

No Format Information found.

Excepción generada

Si Tracefmt no puede dar formato a un parámetro de mensaje de seguimiento, genera una excepción y muestra un mensaje como:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Si ve una excepción similar, revise la definición del mensaje en el código fuente, con especial atención a los tipos de variables especificados por el usuario. Para obtener más información, vea DoTraceMessage.

Archivos TMF con nombres de archivo que no son GUID

Si el nombre del archivo TMF no es un GUID de mensaje, debe usar el parámetro -tmf para identificar el archivo y escribir la ruta de acceso completa al archivo.

Aplicar formato a los mensajes de seguimiento del registrador de kernel de NT

Para dar formato a los mensajes desde la sesión de seguimiento del registrador de kernel NT o una sesión de seguimiento del registrador global, use el parámetro -tmf para especificar el archivo system.tmf, un archivo de formato de mensaje de seguimiento incluido en WDK..

Aplicar formato a los mensajes de seguimiento desde sesiones de seguimiento en tiempo real

Cuando se usa el parámetro -rt (en tiempo real), Tracefmt muestra un mensaje que confirma que está en modo en tiempo real y, a continuación, espera los mensajes de seguimiento del proveedor de seguimiento especificado. No vuelve al símbolo del sistema hasta que se detiene la sesión de seguimiento.

Aplicar formato a las marcas de tiempo de QPC

Tracefmt no da formato a los valores del reloj del contador de rendimiento del sistema (QueryPerformanceCounter) correctamente. Si usa este tiempo de alta resolución, use Tracerpt, una herramienta incluida en Windows, para dar formato a los mensajes de seguimiento. Para obtener más información, vea la descripción del parámetro -UsePerfCounter en sintaxis de comandos de Tracelog.

Mensajes de seguimiento fuera de secuencia

Si ve un archivo de mensaje de seguimiento en un equipo que ejecuta Windows XP, la pantalla podría mostrar mensajes de seguimiento que no están en secuencia. Para corregir este problema, puede usar la opción de número de secuencia al iniciar la sesión de seguimiento y ver el seguimiento mediante Tracefmt. A continuación, puede ver el seguimiento con Traceview y ordenar según el número de secuencia. También puede ver el seguimiento en un equipo que ejecute Windows Server 2003 o versiones posteriores de Windows.