Partilhar via

Opções de linha de comando do WPR

  • Artigo

O Gravador de Desempenho do Windows (WPR) oferece uma interface de linha de comando simples. Toda a complexidade do WPR está incorporada nos perfis de gravação.

Opções gerais

O WPR requer o Windows 8.1 ou uma versão posterior do sistema operacional.

Sintaxe

wpr FirstLevelOption [<arguments>] [Additional options [<arguments>]]

Você pode obter ajuda adicional com:

wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]

As seguintes FirstLevelOptions estão disponíveis:

Opção Descrição
-help Forneça a lista de informações de ajuda de subnível.
-profiles Enumera os nomes e as descrições de perfil de um perfil.
-purgecache Limpa o cache de símbolos dinâmicos.
-start Inicia um ou mais perfis.
-marker Aciona um marcador de evento.
-markerflush (Obsoleto) Aciona um marcador de evento e libera o conjunto de trabalho.
-status Exibe o status de uma gravação ativa (se houver).
-profiledetails Aciona um marcador de evento e libera o conjunto de trabalho.
-exportprofile Exporta um perfil interno para um arquivo.
-providers Exibe informações detalhadas sobre os provedores.
-cancel Cancela a gravação iniciada pelo WPR (se houver).
-stop Cancela e salva a gravação iniciada pelo WPR (se houver).
-merge Mescla arquivos etl no arquivo fornecido.
-flush Libera as sessões de log iniciadas pelo WPR (se houver).
-log Configura as informações de depuração salvas no log de eventos.
-disablepagingexecutive Altera as configurações Desabilitar Executivo de Paginação.
-heaptracingconfig Altera as configurações de rastreamento de heap de um processo.
-snapshotconfig Altere as configurações de instantâneo de um processo.
-capturestateondemand Captura os estados dos provedores configurados na gravação atual.
-pmcsources Consulta a lista de eventos de PMU disponíveis no sistema.
-pmcsessions Consulte a lista de sessões usando eventos de PMU.
-setprofint Define o intervalo de perfil amostrado.
-profint Consulta o intervalo de perfil atual.
-resetprofint Restaura os valores de intervalo de perfil padrão.
-boottrace Configura as entradas do Registro para sessões autologger/globallogger.
-enableperiodicsnapshot Habilita o Instantâneo Periódico para o intervalo especificado e a ID do processo fornecida.
-disableperiodicsnapshot Desabilita o Instantâneo Periódico para todo o processo.
-singlesnapshot Obtém um Instantâneo sob demanda para o processo especificado.

Perfis

A opção Perfis lista os perfis de WPR que a gravação usa.

Sintaxe

wpr -profiles [<path>]

A tabela a seguir descreve os argumentos disponíveis que podem ser aplicados a essa opção. Para ver os perfis internos, omita o argumento.

Argument Descrição
<caminho> Especifica o caminho e o nome do arquivo que contêm as definições de perfil. Por exemplo:

wpr -profiles “c:\Users\User1\Documents\WPR Files\Custom Profiles\CustomProfile1.wprp”

Iniciar

A opção Iniciar inicia uma gravação usando um ou mais perfis.

Sintaxe

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>]

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
<profile> [-start <profilen>]... Especifica um perfil interno ou o caminho para um perfil definido pelo usuário. É possível especificar até 64 perfis em uma única linha de comando, com cada perfil especificado da seguinte maneira:

<profile> := [<filename.wprp>!]<profile name>[.{light|verbose}]

Cada perfil pode definir versões light ou detalhadas ou ambas as versões. Se nenhuma das opções for especificada, a versão detalhada será usada, a menos que o perfil inclua apenas uma versão light.
-shutdown [<KSR>] Especifica que as informações e gravações da sessão persistirão durante a reinicialização. A opção de desligamento funciona apenas com o rastreamento de modo de arquivo, no qual o KSR só funciona com o modo de memória. Chame o comando -stop na próxima inicialização para mesclar o rastreamento.
-filemode Especifica que a gravação é feita no modo de arquivo. (O modo padrão é memória.) Usando essa opção, os dados são gravados em um arquivo ilimitado, que pode aumentar de tamanho até preencher o disco.
-recordtempto <temp folder path> Especifica o caminho da pasta temporária na qual a gravação é salva.
-onoffscenario <OnOff Transition Type> Especifica um dos tipos de transição ativada/desativada. São eles: Boot, FastStartup, Shutdown, RebootCycle, Standby ou Hibernate.
-onoffresultspath <caminho no qual os arquivos de rastreamento são salvos> Especifica o caminho no qual os arquivos de rastreamento são salvos.
-onoffproblemdescription <descrição do cenário> Especifica a descrição do cenário.
-numiterations <número de iterações para rastreamento OnOff> Define o número de iterações para gravação OnOff. Por padrão, são usadas as configurações do arquivo de perfil interno ou personalizado.

Exemplo

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

A opção Parar interrompe a gravação atual e a salva no arquivo especificado pelo argumento.

Sintaxe

wpr -stop <file> <problem description> -[skipPdbGen] [-force] [-compress]

A tabela a seguir descreve os argumentos disponíveis que podem ser aplicados a essa opção.

Argument Descrição
<nome do arquivo> Especifica o arquivo de log de rastreamento de eventos (ETL) no qual o WPR salva a gravação. Esse argumento é necessário.
<descrição do problema> Especifica a descrição do problema. Embora esse argumento seja opcional, recomendamos que você o use.
-skipPdbGen Desabilita a geração dinâmica de pdbs ngen e incorporados para módulos .NET. Essa opção pode reduzir o tempo de operação de parada.
-force Desabilita o aviso quando a extensão do arquivo de destino não é .etl.
-compress Compacta o arquivo de rastreamento de saída.

Mesclar

A opção Mesclar mescla arquivos etl no arquivo fornecido.

Sintaxe

wpr -merge <trace files ...> <merged file> -[skipPdbGen] [-compress] [-supresspii] [-mergeonly] [-injectonly]

A tabela a seguir descreve os argumentos disponíveis que podem ser aplicados a essa opção.

Argument Descrição
<trace files ...> Especifica um ou mais arquivos de log de rastreamento de eventos (ETL) não mesclados. Esse argumento é necessário.
<merged file> Especifica o arquivo de saída no qual o WPR mescla arquivo(s) ETL.
-skipPdbGen Desabilita a geração dinâmica de pdbs ngen e incorporados para módulos .NET. Essa opção pode reduzir o tempo de operação de parada.
-compress Compacta o arquivo de rastreamento de saída.
-supresspii Suprime informações de identificação pessoal (PII).
-mergeonly Mescla os rastreamentos sem adicionar informações específicas da máquina ou eventos de ID de imagem. Não pode ser usado com -injectonly.
-injectonly Gera apenas eventos de id de imagem e/ou específicos da máquina sem copiar eventos originais no arquivo mesclado.

Cancelar

A opção Cancelar cancela a gravação atual sem salvar os dados gravados. Se nenhuma instância estiver ativa no momento, a opção Cancelar retornará um erro.

Sintaxe

wpr -cancel

Essa opção não usa argumentos.

Status

A opção Status exibe informações de status sobre a gravação do WPR atual.

Sintaxe

wpr -status [profiles] [collectors [-details]]

Se nenhuma gravação estiver ativa no momento, será exibida uma mensagem informando que o WPR não está gravando. Se uma gravação estiver ativa no momento e nenhum argumento for usado, as seguintes informações de status serão exibidas:

WPR recording is in progress...

Time since start        : 00:04:27

Dropped event           : 0

Logging mode            : Memory

Se você fornecer argumentos junto com a opção –status, as informações listadas acima serão exibidas junto com os dados específicos dessa opção. A tabela a seguir descreve os argumentos disponíveis que podem ser aplicados a essa opção.

Argumento Descrição e exemplo de saída
perfis Esse argumento lista cada perfil que está sendo usado na gravação do WPR atual.

Exemplo:

Registro da atividade do sistema usando o seguinte conjunto de perfis: 
Profile                 : CPU.Verbose.Memory
collectors Lista as informações do coletor. Se os buffers tiverem sido perdidos, esses buffers serão listados.

Exemplo:

Registrando ativamente coletores: 
Nome do coletor: NT Kernel Logger Tamanho do buffer (KB): 1024 Eventos perdidos : 0 Palavras-chave do sistema CSwitch ProcessThread SampledProfile Sistema Pilhas 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 Lista informações adicionais sobre cada coletor.

Profiledetails

A opção Profiledetails exibe informações detalhadas sobre um perfil ou conjunto de perfis. Para especificar vários perfis, use a sintaxe a seguir, na qual <profilen> se refere ao nome de cada perfil.

Sintaxe

wpr -profiledetails <profile1>+<profile2>+...+<profilen> [-filemode] -onoffscenario <OnOff Transition Type>

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
-filemode Especifica que a gravação foi feita no modo de arquivo. (O modo padrão é memória.)
-onoffscenario <OnOff Transition Type> Especifica um dos tipos de transição ativada/desativada. São eles: Boot, FastStartup, Shutdown, RebootCycle, Standby ou Hibernate.

ExportProfile

A opção ExportProfile exporta o(s) perfil(s) interno(s) para o arquivo fornecido. Use o comando wpr -Profiles para enumerar perfis internos disponíveis. Para especificar vários perfis, use a sintaxe a seguir, na qual <profilen> se refere ao nome de cada perfil. A convenção de nomenclatura dos perfis é exatamente a mesma usada em wpr -start. Um perfil é especificado como <profile name>[.{light|verbose}].

Sintaxe

wpr -exportprofile <profile1>+<profile2>+...+<profilen> <ExportedFileName.wprp> [-filemode]

Esse exemplo exporta o perfil filemode verbose GeneralProfile para o arquivo GeneralProfileVerboseFile.wprp.

Exemplo

wpr -exportprofile GeneralProfile d:\profiles\GeneralProfileVerboseFile.wprp -filemode

Provedores

A opção Providers exibe informações detalhadas sobre os provedores. Os provedores se referem aos componentes ETW (Rastreamento de Eventos para Windows) que expõem eventos ao WPR (Gravador de Desempenho do Windows). Para exibir informações sobre provedores, use a sintaxe a seguir, na qual -providers se refere a todos os provedores instalados/conhecidos e registrados.

Sintaxe

wpr -providers

Essa opção não usa argumentos.

Boottrace

A opção Boottrace configura as entradas do Registro para sessões autologger/globallogger para o perfil especificado.

Sintaxe

wpr -boottrace {-addboot [<filename.wprp>!]<profile> [-addboot <profile> ...] [-filemode] [-recordtempto <temp folder path>] | -stopboot <recording filename> <Problem description> | -cancelboot}

A tabela a seguir descreve as palavras-chave disponíveis que podem ser aplicadas a essa opção.

Argument Descrição
-boottrace Especifica que o argumento a seguir é configurar o autologger. No WPR atual, esse argumento é opcional.
-addboot Define as entradas do registro do autologger para o perfil fornecido. O comando wpr -addboot usa as mesmas opções que o comando wpr -start. Observe que essa opção não inicia imediatamente o rastreamento. Após a reinicialização, o autologger será iniciado pelo sistema operacional.
-stopboot Remove o autologger configurado pelo addboot, interrompe a gravação de inicialização e mescla toda a gravação no arquivo fornecido. Observe que essa opção salva o rastreamento somente se a sessão do autologger estiver em execução (ou seja, após a reinicialização). Caso contrário, essa opção removerá apenas a configuração do autologger.
-cancelboot Remove o autologger configurado pelo addboot e cancela a gravação de inicialização iniciada pelo WPR.

CaptureStateOnDemand

A opção CaptureStateOnDemand captura estados para os provedores configurados na gravação atual. O provedor de eventos deve ser configurado para capturestateondemand dentro do arquivo de perfil enquanto a sessão está em execução.

Sintaxe

wpr-capturestateondemand

Veja abaixo um exemplo de EventProvider:

<EventProvider Id="EventProvider_Microsoft-Windows-Win32k" Name="Microsoft-Windows-Win32k" NonPagedMemory="true" CaptureStateOnly="true">
      <CaptureStateOnDemand Timeout="5">
         <Keyword Value="0x0"/>
      </CaptureStateOnDemand>
    </EventProvider>

Marker

A opção Marcador aciona um marcador de evento com o texto fornecido na sessão de log do sistema atual.

Sintaxe

wpr -marker <text> [-flush]
Argumento Descrição
-flush Libera o conjunto de trabalho. Equivalente a -MarkerFlush.

MarkerFlush (Obsoleto)

A opção MarkerFlush aciona um marcador de evento com o texto fornecido e libera o conjunto de trabalho. Esse comando está obsoleto no WPR atual.

Sintaxe

wpr -markerflush <text>

Liberar

A opção Flush libera sessões de log para arquivos iniciados por meio do WPR.

Sintaxe

wpr -flush

Essa opção não usa argumentos.

HeapTracingConfig

A opção HeapTracingConfig habilita ou desabilita o rastreamento de heap para um processo específico ou aplicativo de armazenamento.

Sintaxe

wpr -HeapTracingConfig <process name> [<package full name> <package relative app ID>] [{enable|disable}]

Observação

  • Se o parâmetro {enable|disable} for omitido, será exibida a configuração atual de rastreamento de heap para o processo ou aplicativo. Por exemplo: wpr -HeapTracingConfig Heaptest.exe enable
  • Esse comando não inicia imediatamente o rastreamento e deve ser executado antes de executar o rastreamento de heap. Consulte Gravação para análise de heap para obter mais detalhes.
  • Sempre desabilite HeapTracingConfig para o processo depois que o rastreamento for feito, pois isso pode afetar o desempenho do processo.

Disablepagingexecutive

A opção Disablepagingexecutive especifica se os drivers e o código do sistema no modo kernel podem ser paginados em disco. Definir essa opção como ativada impede a paginação. Essa opção define o valor de DisablePagingExecutive no Registro.

Sintaxe

wpr -disablepagingexecutive {on | off}

Observação

Para capturar corretamente as pilhas de eventos em sistemas de 64 bits que executam o Windows 7, disablepagingexecutive deve ser definido como Ativado e o sistema deve ser reinicializado antes de iniciar a gravação de desempenho. Para sistemas de 32 bits que executam o Windows 7 e para todos os sistemas que executam o Windows 8 ou superior, você pode operar a gravação de desempenho sem definir disablepagingexecutive como Ativado.

Log

A opção Log acrescenta e configura o log de depuração no log de eventos.

Sintaxe

wpr -log {enabled | disabled | remove}

A tabela a seguir descreve as palavras-chave disponíveis que podem ser aplicadas a essa opção.

Palavra-chave Descrição
Habilitado Habilita o registro de depuração no log de eventos
desabilitado Desabilita o registro de depuração no log de eventos
remove Desinstala o manifesto do provedor de log de depuração do WPR do sistema

Purgecache

A opção Purgecache limpa o cache de símbolos gerenciados.

Sintaxe

wpr -purgecache

Essa opção não usa argumentos.

Ajuda

Use essa opção para exibir a ajuda on-line na janela do Prompt de Comando.

Sintaxe

wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]

A tabela a seguir descreve as palavras-chave disponíveis que podem ser aplicadas a essa opção.

Palavra-chave Descrição
Nenhuma palavra-chave Exibe uma lista de opções e descrições curtas. Para obter mais ajuda para opções específicas, use uma palavra-chave. Por exemplo: wpr -help start.
start Descreve o argumento de linha de comando –start. Para obter mais informações, consulte Iniciar.
stop Descreve o argumento de linha de comando -stop, -merge e -cancel.
status Descreve os argumentos de linha de comando -status. Para obter mais informações, consulte Status.
perfis Descreve os argumentos de linha de comando -profiles, -profiledetails e -exportprofile.
providers Descreve o argumento de linha de comando -providers. Para saber mais, consulte Provedores.
tracing Descreve o argumento de linha de comando –marker, -flush e -capturestateondemand.
boottrace Descreve os argumentos de linha de comando -addboot, -stopboot e -cancelboot.
heap Descreve os argumentos de linha de comando -heaptracingconfig, -snapshotconfig, -enableperiodicsnapshot, -disableperiodicsnapshot e -singlesnapshot.
hardwarecounter Descreve os argumentos de linha de comando -pmcsources, -pmcsessions, -setprofint, -profint, and -resetprofint.
advanced Descreve os argumentos de linha de comando -purgecache, -log, -disablepagingexecutive, -instancename e -container.

SnapshotConfig

A opção SnapshotConfig habilita ou desabilita a capacidade de capturar instantâneos únicos ou periódicos da <opção de snapshot>\ para um processo ou mais processos específicos. Atualmente, você pode tirar instantâneos do heap.

Sintaxe

wpr -SnapshotConfig <snapshot option> {-name <process name> | -pid <pid 1> [pid 2] ...} [{enable|disable}]

Se o parâmetro {enable|disable} for omitido, a configuração de instantâneo atual para o processo será exibida (ou seja, somente a opção -name).

Este exemplo usa o comando snapshotconfig com nomes de imagem:

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

Este exemplo usa o comando snapshotconfig com um PID:

wpr -snapshotconfig heap -pid 8048 enable                //enable snapshot config

Observação

Se o processo e a arquitetura do sistema operacional não corresponderem (por exemplo, um aplicativo win32 em um sistema operacional de 64 bits), use a opção de nome da imagem.

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
<snapshot option> Especifica um dos tipos de opção de instantâneo. Atualmente, está disponível apenas Heap.
-name Especifica o nome do processo. Essa opção não pode ser usada com a opção -Pid. Se essa opção for usada para habilitar o instantâneo, a configuração será aplicada a todas as novas instâncias do nome do processo especificado. Certifique-se de desabilitá-lo quando o teste terminar.
-pid Especifica a ID do processo. Essa opção não pode ser usada com a opção -name. Se essa opção for usada para habilitar o snapshot, a configuração será aplicada imediatamente e durante o tempo de vida do processo.

SingleSnapshot

A opção SingleSnapshot dispara um instantâneo sob demanda da <opção de snapshot> para a ID do processo especificado.

Sintaxe

wpr -SnapshotConfig <snapshot option> <pid 1> [pid 2] ... [up to pid 8]

Observação

O recurso de instantâneo precisa ser habilitado para a ID do processo (ou nome) antes de chamar SingleSnapshot.

Por exemplo: wpr -singlesnapshot heap <pid for foo.exe>

Consulte o comando SnapshotConfig para obter mais informações.

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
<snapshot option> Especifica um dos tipos de opção de instantâneo.
<pid> Especifica a ID do processo.

EnablePeriodicSnapshot

A opção EnablePeriodicSnapshot aciona instantâneos periódicos em intervalos especificados e IDs de processo fornecidas

Sintaxe

wpr -enableperiodicsnapshot <snapshot option> <interval (in seconds)> <pid 1> [pid 2] ... [up to pid 8]

Observação

O recurso de instantâneo precisa ser habilitado para a ID do processo (ou nome) antes de chamar SingleSnapshot.

Por exemplo: wpr -enableperiodicsnapshot heap 60 <pid for foo.exe>

Consulte o comando SnapshotConfig para obter mais informações.

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
<snapshot option> Especifica um dos tipos de opção de instantâneo.
<interval> Especifica o intervalo em segundos. Observe que o intervalo mínimo válido é 5.
<pid> Especifica a ID do processo.

DisablePeriodicSnapshot

A opção DisablePeriodicSnapshot desabilita instantâneos periódicos para todos os processos especificados pela opção enableperiodicsnapshot.

Sintaxe

wpr -disableperiodicsnapshot <snapshot option>

Exemplo

wpr -disableperiodicsnapshot heap

A tabela a seguir descreve as opções disponíveis que podem ser aplicadas a essa opção.

Switch Descrição
<snapshot option> Especifica um dos tipos de opção de instantâneo.

PMCSources

A opção PMCSources consulta a lista de eventos da PMU (Unidade de Monitoramento de Desempenho) no sistema e seu valor de intervalo padrão para o estouro do contador. O intervalo é o número de eventos.

Sintaxe

wpr -pmcsources

Observação

Os eventos da Unidade do Monitor de Desempenho são usados para medir o desempenho da CPU e entender a caracterização da CPU das cargas de trabalho. Somente um subconjunto de eventos da PMU em documentos de referência Arm/intel são implementados no Windows HAL. O exemplo de saída desta opção no dispositivo CPU Intel está abaixo:

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

As opções PMCSessions consultam a lista de sessões usando contadores de hardware. Essa opção está disponível apenas no Windows 11 ou posterior.

Sintaxe

wpr -pmcsessions

ProfInt

A opção ProfInt consulta o intervalo de "criação de perfil".

Sintaxe

wpr -profint

Exemplo

C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -profint
Current Profile Interval = 10000 [1.0000ms]

SetProfInt

A opção SetProfInt define o intervalo do perfil de amostragem para eventos da PMU. Se for omitido o nome do evento da PMU, o padrão será Timer.

Sintaxe

wpr -setprofint [PMU event name] 1221...10000000

Exemplo

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

A opção ResetProfInt redefine o intervalo de perfil para o valor padrão.

Sintaxe

wpr -resetprofint [Profile Source Name]

Observe que, se o [Nome da fonte do perfil] não for fornecido, todas as fontes de perfil serão redefinidas para o valor padrão.

Instancename

A opção Instancename especifica um nome para identificar exclusivamente a instância de rastreamento.

Essa opção pode ser aplicada a qualquer comando que manipule a sessão de log e atribua um nome de sessão de log fornecido pelo usuário. O WPR definirá o nome da sessão padrão se essa opção for omitida.

Sintaxe

wpr –{option <arguments>} -instancename <text>

Observação

-instancename deve ser o último parâmetro. Se as sessões de log foram iniciadas com essa opção, todos os comandos subsequentes deverão usar a mesma opção instancename. Por exemplo:

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

Comentários

Cada vez que o WPR salva um rastreamento que foi capturado quando os aplicativos gerenciados estavam em execução no sistema, o WPR salva símbolos gerenciados ao lado do arquivo de rastreamento. Esse recurso permite a análise de desempenho de aplicativos gerenciados.

A geração de símbolos gerenciados é uma operação que consome recursos e tempo. O WPR cria automaticamente um cache de símbolos gerenciados para agilizar a geração de símbolos gerenciados. Quando o WPR precisa de símbolos gerenciados, primeiro ele verifica esse cache e usa quaisquer símbolos disponíveis e apropriados em vez de regenerá-los.

O local padrão do cache de símbolos gerenciados é C:\ProgramData\WindowsPerformanceRecorder\NGenPdbs_Cache.

Referência do WPR