Opciones de la línea de comandos de WPR
El grabador de rendimiento de Windows (WPR) ofrece una interfaz de línea de comandos sencilla. Toda la complejidad de WPR está integrada en los perfiles de grabación.
Opciones generales
WPR requiere Windows 8.1 o una versión posterior del sistema operativo.
Sintaxis
wpr FirstLevelOption [<arguments>] [Additional options [<arguments>]]
Puede obtener ayuda adicional con:
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
Están disponibles las siguientes FirstLevelOptions:
Opción | Descripción |
---|---|
-help | Proporciona la lista de información de ayuda de nivel secundario. |
-profiles | Enumera los nombres de perfil y las descripciones de un perfil. |
-purgecache | Purga la memoria caché de símbolos dinámicos. |
-start | Inicia uno o varios perfiles. |
-marker | Activa un marcador de eventos. |
-markerflush | (Obsoleto) Activa un marcador de eventos y vacía el conjunto de trabajo. |
-status | Muestra el estado de una grabación activa (si la hay). |
-profiledetails | Activa un marcador de eventos y vacía el conjunto de trabajo. |
-exportprofile | Exporta el perfil integrado a un archivo. |
-providers | Muestra información detallada sobre los proveedores. |
-cancel | Cancela la grabación iniciada por WPR (si la hay). |
-stop | Cancela y guarda la grabación iniciada por WPR (si la hay). |
-merge | Combina archivos .etl en el archivo especificado. |
-flush | Vacía las sesiones de registro iniciadas por WPR (si las hay). |
-log | Configura la información de depuración guardada en el registro de eventos. |
-disablepagingexecutive | Cambia la configuración de Disable Paging Executive. |
-heaptracingconfig | Cambia la configuración de seguimiento del montón de procesos. |
-snapshotconfig | Cambia la configuración de instantáneas de un proceso. |
-capturestateondemand | Captura los estados de los proveedores configurados en la grabación actual. |
-pmcsources | Consulta la lista de eventos PMU disponibles en el sistema. |
-pmcsessions | Consulta la lista de sesiones que usan eventos PMU. |
-setprofint | Establece el intervalo del perfil muestreado. |
-profint | Consulta el intervalo del perfil actual. |
-resetprofint | Restaura los valores de intervalo de perfil predeterminados. |
-boottrace | Configura las entradas del Registro para las sesiones del registrador automático y el registrador global. |
-enableperiodicsnapshot | Habilita Instantánea periódica para el intervalo especificado y el identificador de proceso dado. |
-disableperiodicsnapshot | Deshabilita Instantánea periódica para todos los procesos. |
-singlesnapshot | Obtiene una instantánea a petición para el proceso especificado. |
Perfiles
La opción Profiles enumera los perfiles de WPR que usa la grabación.
Sintaxis
wpr -profiles [<path>]
En la tabla siguiente se describen los argumentos disponibles que puede aplicar a esta opción. Para ver los perfiles integrados, omita el argumento.
Argumento | Descripción |
---|---|
<path> | Especifica la ruta de acceso y el nombre del archivo que contiene las definiciones de perfil. Por ejemplo: wpr -profiles “c:\Users\User1\Documents\WPR Files\Custom Profiles\CustomProfile1.wprp” |
Iniciar
La opción Start inicia una grabación usando uno o varios perfiles.
Sintaxis
wpr -start <profile> [-start <profilen>]... [-filemode] [-recordtempto <temp folder path>] [-onoffscenario <OnOff Transition Type>] [-onoffresultspath <path to which the trace files are saved>] [-onoffproblemdescription <description of the scenario>] [-numiterations <number of iterations for OnOff tracing>]
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
<profile> [-start <profilen>]... | Especifica un perfil integrado o la ruta de acceso a un perfil definido por el usuario. Puede especificar hasta 64 perfiles en una sola línea de comandos. Cada perfil se especifica de la siguiente manera: <perfil> := [<filename.wprp>!]<nombre de perfil>[.{light|verbose}] Cada perfil puede definir versiones ligeras o detalladas, o ambas versiones. Si no se especifica ninguna opción, se usa la versión detallada a menos que el perfil incluya solo una versión ligera. |
-shutdown [<KSR>] | Especifica que la información y las grabaciones de la sesión se conservarán durante el reinicio. La opción Shutdown solo funciona con el seguimiento del modo de archivo, mientras que KSR solo funciona con el modo de memoria. Llame al comando -stop en el siguiente arranque para combinar el seguimiento. |
-filemode | Especifica que la grabación se realiza en modo de archivo. (El modo predeterminado es memoria). Con esta opción, los datos se registran en un archivo sin enlazar, que puede aumentar de tamaño hasta llenar el disco. |
-recordtempto <ruta de acceso de carpeta temporal> | Especifica la ruta de acceso de la carpeta temporal en la que se guarda la grabación. |
-onoffscenario <Tipo de transición encendido/apagado> | Especifica uno de los tipos de transición encendido/apagado. Son los siguientes: Boot, FastStartup, Shutdown, RebootCycle, Standby o Hibernate. |
-onoffresultspath <ruta de acceso en la que se guardan los archivos de seguimiento> | Especifica la ruta de acceso en la que se guardan los archivos de seguimiento. |
-onoffproblemdescription <descripción del escenario> | Especifica la descripción del escenario. |
-numiterations <número de iteraciones para el seguimiento de encendido/apagado> | Establece el número de iteraciones para la grabación de encendido/apagado. De forma predeterminada, se usa la configuración del archivo de perfil integrado o personalizado. |
Ejemplo
wpr -start CPU (Starts verbose CPU profile in memory mode)
wpr -start CPU.light -filemode (Starts light CPU profile in file mode)
wpr -start filename.wprp!ProfileName.Verbose (Starts verbose ProfileName profile defined in filename.wprp)
Stop
La opción Stop detiene la grabación actual y la guarda en el archivo especificado por el argumento.
Sintaxis
wpr -stop <file> <problem description> -[skipPdbGen] [-force] [-compress]
En la tabla siguiente se describen los argumentos disponibles que puede aplicar a esta opción.
Argumento | Descripción |
---|---|
<Nombre de archivo> | Especifica el archivo de registro de seguimiento de eventos (ETL) en el que WPR guarda la grabación. Este argumento es obligatorio. |
<descripción del problema> | Especifica la descripción del problema. Aunque este argumento es opcional, se recomienda usarlo. |
-skipPdbGen | Deshabilita la generación dinámica de archivos .pbs incrustados y .ngen para módulos .NET. Esta opción puede reducir el tiempo de la operación de detención. |
-force | Deshabilita la advertencia cuando la extensión de archivo de destino no es .etl. |
-compress | Comprime el archivo de seguimiento de salida. |
Merge
La opción Merge combina archivos .etl en el archivo especificado.
Sintaxis
wpr -merge <trace files ...> <merged file> -[skipPdbGen] [-compress] [-supresspii] [-mergeonly] [-injectonly]
En la tabla siguiente se describen los argumentos disponibles que puede aplicar a esta opción.
Argumento | Descripción |
---|---|
<archivos de seguimiento...> | Especifica uno o varios archivos de registro de seguimiento de eventos (ETL) no combinados. Este argumento es obligatorio. |
<archivo combinado> | Especifica el archivo de salida en el que WPR combina los archivos ETL. |
-skipPdbGen | Deshabilita la generación dinámica de archivos .pbs incrustados y .ngen para módulos .NET. Esta opción puede reducir el tiempo de la operación de detención. |
-compress | Comprime el archivo de seguimiento de salida. |
-supresspii | Suprime la información de identificación personal (PII). |
-mergeonly | Combina los seguimientos sin agregar información específica de la máquina ni eventos de identificador de imagen. No se puede usar con -injectonly. |
-injectonly | Genera solo eventos específicos de la máquina o el identificador de la imagen sin copiar eventos originales en el archivo combinado. |
Cancelar
La opción Cancel cancela la grabación actual sin guardar los datos grabados. Si no hay ninguna instancia activa actualmente, la opción Cancelar devuelve un error.
Sintaxis
wpr -cancel
Esta opción no toma ningún argumento.
Estado
La opción Status muestra información de estado sobre la grabación actual de WPR.
Sintaxis
wpr -status [profiles] [collectors [-details]]
Si no hay ninguna grabación activa actualmente, un mensaje muestra que WPR no está grabando. Si una grabación está activa actualmente y no se usa ningún argumento, se muestra la siguiente información de estado:
WPR recording is in progress...
Time since start : 00:04:27
Dropped event : 0
Logging mode : Memory
Si proporciona argumentos junto con la opción –status, la información indicada anteriormente se muestra junto con los datos específicos de esa opción. En la tabla siguiente se describen los argumentos disponibles que puede aplicar a esta opción.
Argument | Descripción y ejemplo de salida |
---|---|
profiles | Este argumento enumera cada perfil que se usa en la grabación de WPR actual.
Ejemplo: Grabación de la actividad del sistema mediante el siguiente conjunto de perfiles: |
collectors | Enumera la información de los recopiladores. Si se han perdido búferes, se muestran esos búferes en la lista.
Ejemplo: Actively recording collectors: |
details | Muestra información adicional sobre cada recopilador. |
Profiledetails
La opción Profiledetails muestra información detallada sobre un perfil o un conjunto de perfiles. Para especificar varios perfiles, use la sintaxis siguiente, donde <profilen> se refiere al nombre de cada perfil.
Sintaxis
wpr -profiledetails <profile1>+<profile2>+...+<profilen> [-filemode] -onoffscenario <OnOff Transition Type>
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
-filemode | Especifica que la grabación se realizó en modo de archivo. (El modo predeterminado es memoria). |
-onoffscenario <Tipo de transición encendido/apagado> | Especifica uno de los tipos de transición encendido/apagado. Son los siguientes: Boot, FastStartup, Shutdown, RebootCycle, Standby o Hibernate. |
ExportProfile
La opción ExportProfile exporta los perfiles integrados al archivo especificado. Use el comando wpr -Profiles
para enumerar los perfiles integrados disponibles. Para especificar varios perfiles, use la sintaxis siguiente, donde <profilen>
se refiere al nombre de cada perfil. La convención de nomenclatura de los perfiles es exactamente la misma que se usa en wpr -start
. Un perfil se especifica como <profile name>[.{light|verbose}]
.
Sintaxis
wpr -exportprofile <profile1>+<profile2>+...+<profilen> <ExportedFileName.wprp> [-filemode]
En este ejemplo se exporta el perfil detallado de modo de archivo GeneralProfile al archivo GeneralProfileVerboseFile.wprp.
Ejemplo
wpr -exportprofile GeneralProfile d:\profiles\GeneralProfileVerboseFile.wprp -filemode
Proveedores
La opción Providers muestra información detallada sobre los proveedores. Los proveedores hacen referencia a los componentes de Seguimiento de eventos para Windows (ETW) que exponen eventos al grabador de rendimiento de Windows (WPR). Para ver información sobre los proveedores, use la sintaxis siguiente, donde -providers hace referencia a todos los proveedores instalados o conocidos y registrados.
Sintaxis
wpr -providers
Esta opción no toma ningún argumento.
Boottrace
La opción Boottrace configura las entradas del Registro de las sesiones del registrador automático y el registrador global para el perfil especificado.
Sintaxis
wpr -boottrace {-addboot [<filename.wprp>!]<profile> [-addboot <profile> ...] [-filemode] [-recordtempto <temp folder path>] | -stopboot <recording filename> <Problem description> | -cancelboot}
En la tabla siguiente se describen las palabras clave disponibles que puede aplicar a esta opción.
Argumento | Descripción |
---|---|
-boottrace | Especifica que el argumento siguiente se usa para configurar el registrador automático. En el grabador de rendimiento de Windows actual, este argumento es opcional. |
-addboot | Establece las entradas del Registro del registrador automático para el perfil especificado. El comando wpr -addboot toma las mismas opciones que el comando wpr -start . Tenga en cuenta que estas opciones no inician inmediatamente el seguimiento. Después del reinicio, el sistema operativo iniciará el registrador automático. |
-stopboot | Quita el registrador automático configurado por addboot, detiene la grabación de arranque y combina toda la grabación en el archivo especificado. Esta opción solo guarda el seguimiento si se está ejecutando la sesión del registrador automático (es decir, después del reinicio). De lo contrario, esta opción solo quita la configuración del registrador automático. |
-cancelboot | Quita el registrador automático configurado por addboot y cancela la grabación de arranque iniciada por WPR. |
CaptureStateOnDemand
La opción CaptureStateOnDemand captura los estados de los proveedores configurados en la grabación actual. El proveedor de eventos debe configurarse para capturestateondemand en el archivo de perfil mientras se ejecuta la sesión.
Sintaxis
wpr-capturestateondemand
A continuación, se muestra un ejemplo de EventProvider:
<EventProvider Id="EventProvider_Microsoft-Windows-Win32k" Name="Microsoft-Windows-Win32k" NonPagedMemory="true" CaptureStateOnly="true">
<CaptureStateOnDemand Timeout="5">
<Keyword Value="0x0"/>
</CaptureStateOnDemand>
</EventProvider>
Marcador
La opción Marker activa un marcador de evento con el texto especificado en la sesión de registro del sistema actual.
Sintaxis
wpr -marker <text> [-flush]
Argumento | Descripción |
---|---|
-flush | Vacía el conjunto de trabajo. Equivalente a -MarkerFlush. |
MarkerFlush (obsoleto)
La opción MarkerFlush activa un marcador de evento con el texto especificado y vacía el conjunto de trabajo. Este comando está obsoleto en el grabador de rendimiento de Windows actual.
Sintaxis
wpr -markerflush <text>
Vaciar
La opción Flush vacía las sesiones de registro en los archivos iniciados a través de WPR.
Sintaxis
wpr -flush
Esta opción no toma ningún argumento.
HeapTracingConfig
La opción HeapTracingConfig habilita o deshabilita el seguimiento del montón para un proceso específico o una aplicación de almacenamiento.
Sintaxis
wpr -HeapTracingConfig <process name> [<package full name> <package relative app ID>] [{enable|disable}]
Nota:
- Si se omite el parámetro {enable|disable}, se mostrará la configuración de seguimiento del montón actual para el proceso o la aplicación. Por ejemplo:
wpr -HeapTracingConfig Heaptest.exe enable
- Este comando no inicia inmediatamente el seguimiento y se debe ejecutar antes de tomar el seguimiento del montón. Consulte Grabación para el análisis de la pila para obtener información detallada.
- Deshabilite siempre HeapTracingConfig para el proceso después de realizar el seguimiento, ya que puede afectar al rendimiento del proceso.
Disablepagingexecutive
La opción Disablepagingexecutive especifica si los controladores y el código del sistema en modo kernel se pueden paginar en el disco. Si se establece esta opción en on, se impide la paginación. Esta opción establece el valor de DisablePagingExecutive en el Registro.
Sintaxis
wpr -disablepagingexecutive {on | off}
Nota:
Para capturar correctamente pilas de eventos en sistemas de 64 bits en los que se ejecuta Windows 7, disablepagingexecutive debe establecerse como On y el sistema se debe reiniciar antes de iniciar la grabación de rendimiento. Para sistemas de 32 bits en los que se ejecuta Windows 7 y para todos los sistemas en los que se ejecuta Windows 8 o posterior, puede usar la grabación de rendimiento sin establecer disablepagingexecutive como On.
Registro
La opción Log anexa y configura el registro de depuración en el registro de eventos.
Sintaxis
wpr -log {enabled | disabled | remove}
En la tabla siguiente se describen las palabras clave disponibles que puede aplicar a esta opción.
Palabra clave | Descripción |
---|---|
enabled | Habilita el registro de depuración en el registro de eventos |
disabled (deshabilitado) | Deshabilita el registro de depuración en el registro de eventos |
remove | Desinstala el manifiesto del proveedor de registro de depuración de WPR del sistema. |
Purgecache
La opción Purgecache purga la caché de símbolos administrados.
Sintaxis
wpr -purgecache
Esta opción no toma ningún argumento.
Ayuda
Use esta opción para que se muestre la ayuda en línea en la ventana del símbolo del sistema.
Sintaxis
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
En la tabla siguiente se describen las palabras clave disponibles que puede aplicar a esta opción.
Palabra clave | Descripción |
---|---|
Sin palabra clave | Muestra una lista de opciones y descripciones cortas. Si desea obtener más ayuda para opciones concretas, use una palabra clave. Por ejemplo: wpr -help start . |
start | Describe el argumento –start de la línea de comandos. Para obtener más información, consulte Start. |
stop | Describe los argumentos -stop, -merge y -cancel de la línea de comandos. |
status | Describe los argumentos -status de la línea de comandos. Para obtener más información, consulte Status. |
profiles | Describe los argumentos -profiles, -profiledetails y -exportprofile de la línea de comandos. |
providers | Describe el argumento -providers de la línea de comandos. Para más obtener información, consulte Providers. |
tracing | Describe los argumentos –marker, -flush, and -capturestateondemand de la línea de comandos. |
boottrace | Describe los argumentos -addboot, -stopboot y -cancelboot de la línea de comandos. |
montón | Describe los argumentos -heaptracingconfig, -snapshotconfig, -enableperiodicsnapshot, -disableperiodicsnapshot y -singlesnapshot de la línea de comandos. |
hardwarecounter | Describe los argumentos -pmcsources, -pmcsessions, -setprofint, -profint y -resetprofint de la línea de comandos. |
advanced | Describe los argumentos -purgecache, -log, -disablepagingexecutive, -instancename y -container de la línea de comandos. |
SnapshotConfig
La opción SnapshotConfig habilita o deshabilita la capacidad de capturar instantáneas únicas o periódicas de <opción de instantánea>\ para uno o varios procesos Actualmente puede tomar instantáneas del montón.
Sintaxis
wpr -SnapshotConfig <snapshot option> {-name <process name> | -pid <pid 1> [pid 2] ...} [{enable|disable}]
Si se omite el parámetro {enable|disable}
, se mostrará la configuración de instantánea actual del proceso (es decir, solo la opción -name).
En este ejemplo se usa el comando snapshotconfig con nombres de imágenes:
wpr -snapshotconfig heap -name Win32Project1.exe //query snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe enable //enable snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe disable //disable snapshot config
En este ejemplo se usa el comando snapshotconfig con un PID:
wpr -snapshotconfig heap -pid 8048 enable //enable snapshot config
Nota:
Si el proceso y la arquitectura del sistema operativo no coinciden (por ejemplo, una aplicación win32 en un sistema operativo de 64 bits), use la opción nombre de imagen.
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
<opción de instantánea> | Especifica uno de los tipos de opción de instantánea. Actualmente, solo está disponible Heap. |
-name | Especifica el nombre del proceso. Este modificador no se puede usar con el modificador -pid. Si se usa este modificador para habilitar la instantánea, la configuración se aplicará a todas las nuevas instancias del nombre de proceso especificado. Asegúrese de deshabilitarlo cuando finalice la prueba. |
-pid | Especifica el identificador de proceso. Este modificador no se puede usar con el modificador -name. Si se usa este modificador para habilitar la instantánea, la configuración se aplicará inmediatamente y se usará durante todo el proceso. |
SingleSnapshot
La opción SingleSnapshot activa una instantánea a petición de la opción <opción de instantánea> para el identificador de proceso especificado.
Sintaxis
wpr -SnapshotConfig <snapshot option> <pid 1> [pid 2] ... [up to pid 8]
Nota:
La característica de instantánea se debe habilitar para el identificador (o nombre) de proceso antes de llamar a SingleSnapshot.
Por ejemplo: wpr -singlesnapshot heap <pid for foo.exe>
Consulte el comando SnapshotConfig para obtener más información.
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
<opción de instantánea> | Especifica uno de los tipos de opción de instantánea. |
<pid> | Especifica el identificador del proceso. |
EnablePeriodicSnapshot
La opción EnablePeriodicSnapshot activa instantáneas periódicas a intervalos especificados y para identificadores de proceso concretos.
Sintaxis
wpr -enableperiodicsnapshot <snapshot option> <interval (in seconds)> <pid 1> [pid 2] ... [up to pid 8]
Nota:
La característica de instantánea se debe habilitar para el identificador (o nombre) de proceso antes de llamar a SingleSnapshot.
Por ejemplo: wpr -enableperiodicsnapshot heap 60 <pid for foo.exe>
Consulte el comando SnapshotConfig para obtener más información.
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
<opción de instantánea> | Especifica uno de los tipos de opción de instantánea. |
<intervalo> | Especifica el intervalo en segundos. Tenga en cuenta que el intervalo válido mínimo es de 5 segundos. |
<pid> | Especifica el identificador del proceso. |
DisablePeriodicSnapshot
La opción DisablePeriodicSnapshot deshabilita las instantáneas periódicas para todos los procesos especificados por la opción enableperiodicsnapshot.
Sintaxis
wpr -disableperiodicsnapshot <snapshot option>
Ejemplo
wpr -disableperiodicsnapshot heap
En la tabla siguiente se describen los modificadores disponibles que puede aplicar a esta opción.
Switch | Descripción |
---|---|
<opción de instantánea> | Especifica uno de los tipos de opción de instantánea. |
PMCSources
La opción PMCSources consulta la lista de eventos PMU (Monitor de rendimiento de unidad) en el sistema y su valor de intervalo predeterminado para el desbordamiento del contador. El intervalo es el número de eventos.
Sintaxis
wpr -pmcsources
Nota:
Los eventos PMU se usan para medir el rendimiento de la CPU y comprender la caracterización de la CPU de las cargas de trabajo. Solo se implementa un subconjunto de eventos PMU en documentos de referencia de Arm/Intel en Windows HAL. A continuación se muestra un ejemplo de salida de esta opción en el dispositivo de CPU Intel:
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -pmcsources
Id Name Interval Min Max
--------------------------------------------------------------
0 Timer 10000 1221 1000000
2 TotalIssues 698400 4096 2147483647
6 BranchInstructions 65536 4096 2147483647
10 CacheMisses 65536 4096 2147483647
11 BranchMispredictions 65536 4096 2147483647
19 TotalCycles 65536 4096 2147483647
25 UnhaltedCoreCycles 65536 4096 2147483647
26 InstructionRetired 65536 4096 2147483647
27 UnhaltedReferenceCycles 65536 4096 2147483647
28 LLCReference 65536 4096 2147483647
29 LLCMisses 65536 4096 2147483647
30 BranchInstructionRetired 65536 4096 2147483647
31 BranchMispredictsRetired 65536 4096 2147483647
32 LbrInserts 65536 4096 2147483647
PMCSessions
Las opciones PMCSessions consultan la lista de sesiones mediante contadores de hardware. Esta opción solo está disponible en Windows 11 o posterior.
Sintaxis
wpr -pmcsessions
ProfInt
La opción ProfInt consulta el intervalo de generación de perfiles.
Sintaxis
wpr -profint
Ejemplo
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -profint
Current Profile Interval = 10000 [1.0000ms]
SetProfInt
La opción SetProfInt establece el intervalo de perfil de muestreo para eventos PMU. Si se omite el nombre del evento PMU, el valor predeterminado es Timer.
Sintaxis
wpr -setprofint [PMU event name] 1221...10000000
Ejemplo
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint 100000
New Profile Interval = 100000 [10.0000ms]
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint TotalIssues 1000000
New Profile Interval = 100000 [Counter: TotalIssues]
ResetProfInt
La opción ResetProfInt restablece el valor predeterminado del intervalo de perfil.
Sintaxis
wpr -resetprofint [Profile Source Name]
Tenga en cuenta que si no se proporciona [Nombre de origen del perfil], se restablecerá el valor predeterminado de todos los orígenes de perfil.
Instancename
La opción Instancename especifica un nombre para identificar de forma única la instancia de seguimiento.
Esta opción se puede aplicar a cualquier comando que manipule la sesión de registro y asigna un nombre de sesión de registro proporcionado por el usuario. WPR establece el nombre de sesión predeterminado si se omite esta opción.
Sintaxis
wpr –{option <arguments>} -instancename <text>
Nota:
-instancename debe ser el último parámetro. Si las sesiones de registro se iniciaron con esta opción, todos los comandos subsiguientes deben usar la misma opción instancename. Por ejemplo:
C:\wpt>wpr -start cpu -instancename CpuSession
C:\wpt>wpr -status -instancename CpuSession
WPR recording is in progress...
...
Time since start : 00:00:05
Dropped event : 0
Logging mode : Memory
C:\wpt>wpr -stop cpu.etl -> omitting instancename option would not find CpuSession
There are no trace profiles running.
Error code: 0xc5583000
C:\wpt>wpr -stop cpu.etl -instancename CpuSession -> trace will be saved
Comentarios
Cada vez que WPR guarda un seguimiento que se capturó cuando las aplicaciones administradas se estaban ejecutando en el sistema, WPR guarda los símbolos administrados junto al archivo de seguimiento. Esta característica permite el análisis de rendimiento de las aplicaciones administradas.
La generación de símbolos administrados es una operación que consume mucho tiempo y recursos. WPR crea automáticamente una memoria caché de símbolos administrados para acelerar la generación de símbolos administrados. Cuando WPR necesita símbolos administrados, primero comprueba esta memoria caché y usa los símbolos disponibles y adecuados en lugar de regenerarlos.
La ubicación predeterminada de la memoria caché de símbolos administrados es C:\ProgramData\WindowsPerformanceRecorder\NGenPdbs_Cache.