Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As ferramentas do Build Insights do C++ estão disponíveis a partir do Visual Studio 2019 e posterior. Para ver a documentação dessa versão, defina o controle seletor de Versão do Visual Studio para Visual Studio 2019 ou posterior. Ele é encontrado na parte superior da tabela de conteúdo nesta página.
Este artigo lista e descreve os comandos disponíveis em vcperf.exe e como usá-los.
Comandos para iniciar e parar rastreamentos
Importante
A menos que você especifique /noadmin, os comandos a seguir exigem privilégios administrativos.
| Opção | Argumentos e descrição |
|---|---|
/start |
[/noadmin] [/nocpusampling] [/enableSilos] [/level1/level3 | /level2 | ] <sessionName> |
| Inicia um rastreamento com o nome de sessão fornecido. A /noadmin opção é executada vcperf.exe sem privilégios de administrador e ignora a /nocpusampling opção. Quando você executa vcperf sem privilégios de administrador, pode haver mais de uma sessão ativa em uma determinada máquina. A /nocpusampling opção especifica vcperf.exe não coleta amostras de CPU. Isso impede o uso da visão de Uso da CPU (Amostrado) no Windows Performance Analyzer, mas reduz o tamanho dos traços coletados. As opções /level1, /level2 ou /level3 especificam quais eventos MSVC coletar, em níveis crescentes de informações. O nível 3 inclui todos os eventos. O nível 2 inclui todos os eventos, exceto eventos de instanciação de modelo. O nível 1 inclui todos os eventos, exceto instanciação de modelo, função e eventos de arquivo. Se não for especificado, /level2 é selecionado por padrão. Para coletar eventos de instanciação de modelo para análise com /templates, use /level3. Assim que vcperf.exe inicia o rastreamento, ele retorna imediatamente. O rastreamento coleta eventos para processos em todo o sistema. Isso significa que você não precisa criar seu projeto na mesma janela de prompt de comando que a que você usa para executar vcperf.exe. Por exemplo, você pode criar seu projeto no Visual Studio. |
|
/enableSilos A opção, quando disponível, permite que uma sessão de rastreamento de host colete eventos MSVC de silos de servidor do Windows, incluindo contêineres do Windows com isolamento por processo (não contêineres com isolamento Hyper-V). A coleta de silo está desativada por padrão. Ele afeta apenas o provedor MSVC e não altera as configurações de evento do sistema ou de amostragem de CPU. |
|
/stop |
(1) [/templates] <sessionName> <outputFile.etl> (2) [ /templates] <sessionName> /timetrace <outputFile.json> |
Interrompe o rastreamento identificado pelo nome da sessão fornecido. Executa uma etapa de pós-processamento do rastreamento para gerar um arquivo especificado pelo parâmetro <outputFile>. A /templates opção inclui eventos de instanciação de modelo no arquivo se o rastreamento foi iniciado com /level3. (1) Gera um arquivo visível no Windows Performance Analyzer (WPA). O arquivo de saída requer uma .etl extensão.(2) Gera um arquivo visível no visualizador de rastreamento do Microsoft Edge ( edge://tracing). O arquivo de saída requer uma .json extensão. |
|
/stopnoanalyze |
<sessionName> <rawOutputFile.etl> |
| Interrompe o rastreamento identificado pelo nome da sessão fornecido e grava os dados brutos não processados no arquivo de saída especificado. O arquivo resultante não se destina à visualização no WPA. A etapa pós-processamento envolvida no comando /stop às vezes pode ser longa. Você pode usar o comando /stopnoanalyze para atrasar esta etapa pós-processamento. Use o /analyze comando quando estiver pronto para produzir um arquivo visível no Windows Performance Analyzer ou no visualizador de rastreamento do Microsoft Edge. |
Comandos variados
| Opção | Argumentos e descrição |
|---|---|
/analyze |
(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [ /templates] <rawInputFile.etl> /timetrace <outputFile.json> |
Aceita um arquivo de rastreamento bruto produzido pelo comando /stopnoanalyze. Executa uma etapa de pós-processamento nesse rastreamento para gerar o arquivo especificado pelo <outputFile> parâmetro. A opção /templates inclui eventos de instanciação de modelo no arquivo se o rastreamento foi iniciado com /level3. (1) Gera um arquivo visível no Windows Performance Analyzer (WPA). O arquivo de saída requer uma .etl extensão. (2) Gera um arquivo visível no visualizador de rastreamento do Microsoft Edge ( edge://tracing). O arquivo de saída requer uma .json extensão. |
|
/grantusercontrol |
Sem argumentos. |
Concede ao usuário atual permissão para iniciar e parar sessões de rastreamento vcperf que usam /noadmin sem elevação. Execute vcperf /grantusercontrol a partir de um prompt de comando com privilégios elevados uma vez por usuário em cada computador. A amostragem de CPU ainda requer um rastreamento executado com privilégios elevados sem /noadmin. O comando foi adicionado na versão vcperf 2.5.25121101. |
Rastrear sem privilégios de administrador
Em um prompt de comando com privilégios elevados, conceda ao usuário atual permissão para controlar as sessões de rastreamento:
vcperf /grantusercontrol
Em um prompt de comando sem elevação, inicie um rastreamento:
vcperf /start /noadmin MySession
Compile seu projeto e, em seguida, interrompa o rastreamento de um prompt de comando sem elevação:
vcperf /stop MySession output.etl
Confira também
Introdução ao C++ Build Insights
Tutorial: Windows Performance Analyzer noções básicas
Referência: Windows Performance Analyzer exibições
Windows Performance Analyzer