Comandos de control de TraceView
Nota:
Las opciones de línea de comandos traceView están en desuso. Use tracepdb.exe y tracefmt.exe para analizar archivos PDB en archivos TMF y analizar archivos .etl en texto, respectivamente.content.
Use un comando de control Traceview para administrar las sesiones de seguimiento, como iniciar y detener la sesión, habilitar y deshabilitar proveedores, actualizar las propiedades de la sesión de seguimiento y vaciar los búferes de seguimiento.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Parámetros de comando
Acciones
Parámetros
SessionName
Cuando se usa con -start, SessionName es un nombre que se selecciona para representar la sesión de seguimiento. Con todos los demás comandos, SessionName identifica la sesión de seguimiento.
-f [LogFile]
Cuando se usa con -start, -f inicia una sesión de registro de seguimiento. LogFile especifica la ruta de acceso (opcional) y el nombre de archivo del archivo de registro de seguimiento de eventos (.etl). El valor predeterminado es C:\LogFile.etl.
Cuando se usa con -update, -f envía todos los nuevos mensajes de seguimiento solo al registro de seguimiento especificado. Use este parámetro para convertir una sesión de seguimiento en tiempo real en una sesión de registro de seguimiento o para iniciar un nuevo registro de seguimiento para una sesión de registro de seguimiento existente. Para enviar mensajes de seguimiento a un consumidor de seguimiento en tiempo real y a un registro de seguimiento, use los parámetros -rt y -f en el comando -update .
-Rt
Cuando se usa con -start, -rt inicia una sesión de seguimiento en tiempo real (una sesión de registro de seguimiento (-f) es la predeterminada). Si usa -rt y -f en un comando -start , los mensajes de seguimiento se envían al consumidor de seguimiento y a un archivo de registro de seguimiento de eventos.
Cuando se usa con -update, -rt agrega la entrega de mensajes en tiempo real a una sesión de registro de seguimiento. Todos los mensajes de seguimiento nuevos se envían directamente al consumidor de seguimiento (como en una sesión de seguimiento en tiempo real), además de un registro de seguimiento.
-guid {#GUID | GuidFile}
Especifica uno o varios proveedores de seguimiento. Use con -start para habilitar proveedores para una sesión de seguimiento. Use con -enable para habilitar los proveedores o cambiar sus valores -flag o -level . Use con -disable para especificar los proveedores que se van a deshabilitar.
EL GUID puede especificar un GUID de control (precedido por un signo de número (#)) o la ruta de acceso (opcional) y el nombre de archivo de un archivo de texto, como un archivo GUID de control (.ctl), que contiene los GUID de control de uno o varios proveedores de seguimiento.
Si omite el parámetro -guid de un comando -start , TraceView inicia una sesión de seguimiento del registrador de kernel de NT.
TraceView pasa los valores de los siguientes subparámetros a los proveedores especificados.
| Parámetro | Descripción |
|---|---|
| SessionName | Cuando se usa con -start, SessionName es un nombre que se selecciona para representar la sesión de seguimiento. Con todos los demás comandos, SessionName identifica la sesión de seguimiento. |
| -f \[LogFile\] | Cuando se usa con -start, -f inicia una sesión de registro de seguimiento. LogFile especifica la ruta de acceso (opcional) y el nombre de archivo del archivo de registro de seguimiento de eventos (.etl). El valor predeterminado es C:\\LogFile.etl. Cuando se usa con -update, -f envía todos los nuevos mensajes de seguimiento solo al [registro de seguimiento] especificado(trace-log.md). Use este parámetro para convertir una sesión de seguimiento en tiempo real en una sesión de registro de seguimiento o para iniciar un nuevo registro de seguimiento para una sesión de registro de seguimiento existente. Para enviar mensajes de seguimiento a un consumidor de seguimiento en tiempo real y a un registro de seguimiento, use los parámetros -rt y -f en el comando -update . |
| -Rt | Cuando se usa con -start, -rt inicia una sesión de seguimiento en tiempo real (una sesión de registro de seguimiento (-f) es la predeterminada). Si usa -rt y -f en un comando -start , los mensajes de seguimiento se envían al consumidor de seguimiento y a un archivo de registro de seguimiento de eventos. Cuando se usa con -update, -rt agrega la entrega de mensajes en tiempo real a una sesión de registro de seguimiento. Todos los nuevos mensajes de seguimiento se envían directamente al consumidor de seguimiento (como en una sesión de seguimiento en tiempo real), además de un [registro de seguimiento](trace-log.md). |
| -guid {\#GUID | GuidFile} | Especifica uno o varios proveedores de seguimiento. Use con -start para habilitar proveedores para una sesión de seguimiento. Use con -enable para habilitar los proveedores o cambiar sus valores -flag o -level . Use con -disable para especificar los proveedores que se van a deshabilitar. GUID puede especificar un [GUID de control](control-guid.md) (precedido por un signo de número (\#)) o la ruta de acceso (opcional) y el nombre de archivo de un archivo de texto, como un archivo GUID de control (.ctl), que contiene los GUID de control de uno o varios proveedores de seguimiento. Si omite el parámetro -guid de un comando -start , TraceView inicia una sesión de seguimiento del registrador de kernel de NT](nt-kernel-logger-trace-session.md). |
TraceView pasa los valores de los siguientes subparámetros al proveedor especificado:
-b BufferSize
Especifica el tamaño, en KB, de cada búfer asignado para la sesión de seguimiento. Use solo con -start.
El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso.
-min NumberOfBuffers
Especifica el número de búferes asignados inicialmente para almacenar mensajes de seguimiento. Use solo con -start.
El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso.
-máximo NumberOfBuffers
Cuando se usa con -start, -max especifica el número máximo de búferes asignados para la sesión de seguimiento. El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso.
Cuando se usa con -update, -max cambia el número máximo de búferes asignados a la sesión de seguimiento.
-Pies FlushTime
Cuando se usa con -start, -ft especifica con qué frecuencia, en segundos, se vacían los búferes de mensajes de seguimiento. Cuando se usa con -update, -ft cambia el tiempo de vaciado a la hora especificada.
El tiempo de vaciado mínimo es de 1 segundo. El valor predeterminado es 0 (sin vaciado forzado).
Este vaciado forzado se suma a los vaciados que se producen automáticamente cada vez que un búfer de mensajes de seguimiento está lleno y cuando se detiene una sesión de seguimiento.
Vea también: -flush.
-Paginado
Usa memoria paginable para los búferes de mensajes de seguimiento. De forma predeterminada, el seguimiento de eventos usa memoria no paginable para los búferes. Use solo con -start.
No use este parámetro cuando el proveedor sea un controlador que pueda generar mensajes de seguimiento en un IRQL mayor que DISPATCH_LEVEL.
Este parámetro no se admite en Windows 2000.
-Seq MaxFileSize
Especifica el registro secuencial (al final del archivo, detener los eventos de grabación) en el archivo del registro de seguimiento de eventos (.etl). Use solo con -start.
MaxFileSize especifica el tamaño máximo del archivo en MB. Sin un valor MaxFileSize , este parámetro se omite.
El registro secuencial es el predeterminado, pero puede usar este parámetro para establecer el tamaño máximo de archivo o para usar -prealloc. Sin este parámetro, no hay ningún límite de tamaño de archivo.
-Cir MaxFileSize
Especifica el registro circular (al final del archivo, registrar nuevos mensajes sobre los mensajes más antiguos) en el archivo del registro de seguimiento de eventos (.etl). Use solo con -start.
MaxFileSize especifica el tamaño máximo del archivo en MB. Sin un valor MaxFileSize , este parámetro se omite.
El valor predeterminado es el registro secuencial sin límite de tamaño de archivo.
-prealloc
Reserva espacio para el archivo del registro de seguimiento de eventos (.etl) antes de asignarlo. Use solo con -start.
Este parámetro requiere -seq o -cir con MaxFileSize. No es válido con -newfile.
Flag representa un valor de marca definido en el proveedor de seguimiento, en formato decimal o hexadecimal. El valor predeterminado es 0. Los valores de 0x01000000 a través de 0xFF000000 están reservados para uso futuro.
Cada proveedor de seguimiento define el significado de las marcas de forma independiente. Normalmente, las marcas representan niveles de informes cada vez más detallados.
En un comando -start , el valor flags se aplica a todos los proveedores de seguimiento de la sesión de seguimiento. Para establecer marcas diferentes para cada proveedor de seguimiento, use un comando -enable independiente para cada proveedor de seguimiento.
| Subparámetros de -guid | Descripción |
|---|---|
-flag Flag |
|
|
-level Level |
Especifica el nivel de seguimiento de los proveedores en la sesión de seguimiento. El nivel determina qué eventos genera el proveedor de seguimiento. Level representa un valor de nivel en formato decimal o hexadecimal. El valor predeterminado es 0. Cada proveedor de seguimiento define el significado del valor de nivel de forma independiente. Normalmente, el nivel de seguimiento representa la gravedad del evento (información, advertencia o error). En un comando -start , el valor de nivel se aplica a todos los proveedores de seguimiento de la sesión de seguimiento. Para establecer distintos niveles para cada proveedor de seguimiento, use un comando -enable independiente para cada proveedor de seguimiento. |
| -b BufferSize | Especifica el tamaño, en KB, de cada búfer asignado para la sesión de seguimiento. Use solo con -start.
El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso. |
| -min NumberOfBuffers | Especifica el número de búferes asignados inicialmente para almacenar mensajes de seguimiento. Use solo con -start.
El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso. |
| -max NumberOfBuffers | Cuando se usa con -start, -max especifica el número máximo de búferes asignados para la sesión de seguimiento. El valor predeterminado viene determinado por el número de procesadores, la cantidad de memoria física y el sistema operativo en uso.
Cuando se usa con -update, -max cambia el número máximo de búferes asignados a la sesión de seguimiento. |
| -ft FlushTime | Cuando se usa con -start, -ft especifica con qué frecuencia, en segundos, se vacían los búferes de mensajes de seguimiento. Cuando se usa con -update, -ft cambia el tiempo de vaciado a la hora especificada.
El tiempo de vaciado mínimo es de 1 segundo. El valor predeterminado es 0 (sin vaciado forzado). Este vaciado forzado se suma a los vaciados que se producen automáticamente cada vez que un búfer de mensajes de seguimiento está lleno y cuando se detiene una sesión de seguimiento. Vea también: -flush. |
| -age AgeLimit | Cuando se usa con -start, -age especifica cuánto tiempo (en minutos) se conservan los búferes de seguimiento sin usar antes de liberarse. Cuando se usa con -update, -age cambia el límite de edad al valor especificado.
Límite de antigüedad especifica cuánto tiempo (en minutos) se conservan los búferes de seguimiento sin usar antes de liberarse. El valor predeterminado es 15 minutos. Este parámetro solo es válido en Windows 2000. |
| -Paginado | Usa memoria paginable para los búferes de mensajes de seguimiento. De forma predeterminada, el seguimiento de eventos usa memoria no paginable para los búferes. Use solo con -start.
No use este parámetro cuando el proveedor sea un controlador que pueda generar mensajes de seguimiento en un IRQL mayor que DISPATCH\_LEVEL. Este parámetro no se admite en Windows 2000. |
| -seq MaxFileSize | Especifica el registro secuencial (al final del archivo, detener los eventos de grabación) en el archivo del registro de seguimiento de eventos (.etl). Use solo con -start.
MaxFileSize especifica el tamaño máximo del archivo en MB. Sin un valor MaxFileSize , este parámetro se omite. El registro secuencial es el predeterminado, pero puede usar este parámetro para establecer el tamaño máximo de archivo o para usar -prealloc. Sin este parámetro, no hay ningún límite de tamaño de archivo. |
| -cir MaxFileSize | Especifica el registro circular (al final del archivo, registrar nuevos mensajes sobre los mensajes más antiguos) en el archivo del registro de seguimiento de eventos (.etl). Use solo con -start.
MaxFileSize especifica el tamaño máximo del archivo en MB. Sin un valor MaxFileSize , este parámetro se omite. El valor predeterminado es el registro secuencial sin límite de tamaño de archivo. |
| -prealloc | Reserva espacio para el archivo del registro de seguimiento de eventos (.etl) antes de asignarlo. Use solo con -start.
Este parámetro requiere -seq o -cir con MaxFileSize. No es válido con -newfile. El sistema crea el archivo de registro de seguimiento de eventos (.etl) con un tamaño igual al valor MaxFileSize especificado mediante los parámetros -seq o -cir . Al detener la sesión, reduce el archivo de registro al tamaño de su contenido. |
| -newfile MaxFileSize | Crea un nuevo archivo de registro de seguimiento de eventos (.etl) cada vez que el archivo existente alcanza MaxFileSize. Use solo con -start.
MaxFileSize especifica el tamaño máximo de cada archivo de registro en MB. Sin un valor MaxFileSize , este parámetro se omite. Al usar -newfile, también debe usar el parámetro -f LogFile y el valor de LogFile debe ser un nombre que incluya los caracteres %d indicar un patrón decimal; por ejemplo, trace%d.etl. De lo contrario, se produce un error en el comando con ERROR\_INVALID\_NAME. Windows incrementa el valor decimal en el nombre de archivo cada vez que crea un nuevo archivo. Este parámetro no es válido con la asignación previa (-prealloc logging (-cir), con la sesión del registrador de kernel NT o para las sesiones de seguimiento privadas. No se admite en Windows 2000. |
| -añadir | Anexa los mensajes de seguimiento a un archivo de registro de seguimiento de eventos (.etl) existente. El valor predeterminado es crear un nuevo archivo. Use solo con -start.
Este parámetro solo es válido en archivos secuenciales y solo cuando se usa -f y -rt no se usa. No se admite en Windows 2000. |
| -kd | Redirige los mensajes de seguimiento a KD o Windbg, lo que esté asociado. Este parámetro también establece el tamaño del búfer de seguimiento en 3 KB, el tamaño máximo del búfer para el depurador y omite los parámetros -b del comando. Use solo con -start. |
Comentarios
Un comando traceview sin parámetros abre la ventana TraceView.
Puede usar el comando TraceView -start para iniciar una sesión de seguimiento del registrador global. Para ello, use el siguiente formato de comando. A diferencia de otros comandos, la palabra "GlobalLogger" en este formato de comando distingue mayúsculas de minúsculas.
traceview -start GlobalLogger [parameters]