Opções de linha de comando do WPR
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: |
| collectors | Lista as informações do coletor. Se os buffers tiverem sido perdidos, esses buffers serão listados.
Exemplo: Registrando ativamente coletores: |
| 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.