start
Muestra las opciones de inicio del registrador.
xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]
Parámetros
| Comando | Descripción |
|---|---|
-start [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Inicia una sesión de registro para LoggerName, inicia los registros del perfil ProfileName definido en el archivo ProfileFileName o inicia el registro SessionName definido en el archivo ProfileFileName. |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Actualiza una sesión de registro para LoggerName, actualiza los registros del perfil ProfileName definido en el archivo ProfileFileName o actualiza el registro SessionName definido en el archivo ProfileFileName. |
-flush LoggerName |
Vacía una sesión de registro de LoggerName. Este parámetro es necesario para guardar un seguimiento de modo de búfer (consulte el parámetro -buffering). Para guardar un seguimiento de modo de búfer, debe emitir el parámetro -flush. |
-capturestate LoggerName Flags |
Captura el estado en la sesión de registro que no es de kernel de los proveedores especificados en Flags. El formato de proveedor aceptado es el mismo que para -on. Si se especifican marcas y niveles, se habilitan al capturar el estado. Se llama a este comando para el seguimiento iniciado con la opción –buffering. Debe ir seguido de –stop para detener el seguimiento. |
-on Flags|Groups |
Para las sesiones de registro de kernel, la secuencia de marcas y grupos de kernel que se van a habilitar, separados por signos más (+). Para las sesiones de registro de usuarios, la secuencia de proveedores que se van a habilitar, separados por signos más (+). El formato de proveedor aceptado es |
-f filename |
Registra eventos en el archivo especificado. El valor predeterminado es \Kernel.etl para los seguimientos de kernel y \User.etl para los seguimientos de usuario. |
-buffersize Size |
Establece el tamaño del búfer en Size, expresado en KB. Los valores posibles son de 4 a 1024. El valor predeterminado es 64. |
-minbuffers n |
Establece el número mínimo de búferes de seguimiento en n. El valor predeterminado es 64. |
-maxbuffers n |
Establece el número máximo de búferes de seguimiento en n. El valor predeterminado es 320. |
-maxfile Size |
Establece el tamaño de archivo máximo en Size MB. |
-flushtimer n |
Establece el temporizador de vaciado en n segundos. |
-boottrace Flags|Groups|off |
Configura el registrador de seguimiento de eventos para Windows para realizar el seguimiento del arranque. Establezca las marcas en "off" para desactivar el seguimiento del arranque. Todos los controles de registro se pueden usar en combinación con esto. Use junto con -f para registrar en un archivo distinto de \Perf.etl. |
-realtime |
Habilita el seguimiento en tiempo real. |
-buffering |
Habilita el seguimiento en modo de almacenamiento en búfer. Para guardar, use -flush. La opción -stop no guarda el seguimiento. |
-filemode Mode |
Establece el modo de archivo. El valor predeterminado es "Sequential". Modos posibles: "Sequential", "Circular", "Append" y "NewFile". |
-clocktype ClockType |
Establece el tipo de reloj. El valor predeterminado es "PerfCounter". Tipos posibles: "Cycle", "PerfCounter" y "SystemTime". |
-stackwalk flags|@file |
Habilita el recorrido de pila para los eventos especificados como |
-pids pid [...] |
Aplica marcas a los procesos Al especificar varios pids, sepárelos con un espacio, como en |
-pidnewprocess <command-line> |
Aplica marcas a un nuevo proceso que Xperf comenzará con <command-line>. Se usa junto con registradores privados. |
-waitfornewprocess |
Espera a que se cree un nuevo proceso mediante |
-heap |
Habilita el seguimiento del montón en procesos especificados por Pids y PidNewProcess. |
-critsec |
Habilita el seguimiento de secciones críticas en procesos especificados por Pids y PidNewProcess. |
-setprofint [<n>] [cached] |
Establece el intervalo de perfil muestreado en |
-save ProfileFileName!ProfileName|SessionName merged.etl |
Vacía los registradores del perfil ProfileName definido en ProfileFileName y combina los archivos ETL con merged.etl; o vacía el registrador SessionName definido en el archivo ProfileFileName y combina el archivo ETL con merged.etl. |
-seteresourcesample <n1><n2><n3> |
Establece el muestreo ERESOURCE, donde la frecuencia de muestreo de liberación n1 es mayor o igual que 1000, la frecuencia de muestreo de contención n2 es mayor o igual que 1 y el número n3 de tiempos de espera excesivos es mayor o igual que 1. La frecuencia de muestreo de contención es la velocidad a la que se adquieren eventos de bloqueo por subproceso cuando se producen colisiones. Por ejemplo, si este valor es 100, se adquiere un evento de bloqueo por cada cien colisiones de bloqueo por subproceso. |
-setspinlocksample <n1><n2><n3> |
Establece el umbral de número de bloqueo por subproceso en |
-pooltag <P1>+<P2>+<P3>+<P4> |
Establece los filtros de etiquetas de grupo (Pn) separados por signos más (+) o de punto y coma (;). Use un signo de interrogación (?) para indicar un comodín de un solo carácter o un asterisco (*) para un comodín de varios caracteres. Se puede especificar un máximo de cuatro filtros. |
Comentarios
Se pueden iniciar varios registradores mediante varias opciones de inicio, cada una seguida de las opciones que se aplicarán a ese registrador. Si se omite LoggerName o -start LoggerName, el registrador del kernel está implícito. Solo puede existir una única instancia del registrador del kernel en cada momento. Si uno de los registradores no se inicia, se detienen todos los registradores que ya están iniciados.