Compartir a través de


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: 

Profile : CPU.Verbose.Memory

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: 

Collector Name : NT Kernel Logger Buffer Size (KB) : 1024 Events Lost : 0 System Keywords CSwitch ProcessThread SampledProfile System Stacks CSwitch SampledProfile

Collector Name : WPR_initiated_WPR Event Collector Buffer Size (KB) : 1024 Events Lost : 0 Providers Microsoft-Windows-Shell-Core: 0x1000000000000: 0x04 Microsoft-Windows-Win32k: 0x1000000402000: 0xff : Stack CaptureState Providers on Save Microsoft-Windows-Win32k: 0x80000: 0xff

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.

Referencia de WPR