Referência: comandos vcperf

As ferramentas do C++ Build Insights estão disponíveis a partir do Visual Studio 2019 e posterior. Para consultar a documentação dessa versão, ajuste o seletor de versão do Visual Studio neste artigo para Visual Studio 2019 ou posterior. Encontra-se na parte superior do índice desta página.

Este artigo lista e descreve os comandos disponíveis no 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] [/level3/level1 | /level2 | ] <sessionName>
Inicia um rastreamento sob o nome da 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. Ele impede o uso do modo de exibição Uso da CPU (Amostrado) no Analisador de Desempenho do Windows, mas torna os rastreamentos coletados menores.

As opções /level1, /level2 ou /level3 especificam quais eventos MSVC recolher, num nível crescente de informação. 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 recolher eventos de instanciação de modelos para análise com /templates, utilize /level3.

Assim que vcperf.exe inicia o rastreamento, ele retorna imediatamente. O rastreio recolhe eventos de processos em todo o sistema. Isso significa que você não precisa criar seu projeto na mesma janela de prompt de comando que você usa para executar vcperf.exe. Por exemplo, você pode criar seu projeto no Visual Studio.
A opção /enableSilos, quando disponível, permite que uma sessão de rastreio de host recolha eventos MSVC de silos de servidor do Windows, incluindo contentores do Windows isolados por processos (não contentores que utilizam isolamento Hyper-V). A coleção de silos está desativada por predefinição. Afeta apenas o fornecedor MSVC e não altera as definições de eventos do sistema ou de amostragem da 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 no rastreamento para gerar um arquivo especificado pelo parâmetro <outputFile>.

A /templates opção inclui eventos de instância de modelo no ficheiro caso o rastreio tenha sido iniciado com /level3.

(1) Gera um ficheiro visível no Windows Analisador de Desempenho (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 e não processados no arquivo de saída especificado. O ficheiro resultante não se destina a visualização em WPA.

A etapa de pós-processamento envolvida no /stop comando às vezes pode ser longa. Você pode usar o comando para atrasar /stopnoanalyze essa etapa de pós-processamento. Use o /analyze comando quando estiver pronto para produzir um arquivo visível no Analisador de Desempenho do Windows ou no visualizador de rastreamento do Microsoft Edge.

Comandos diversos

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 /stopnoanalyze comando. Executa uma etapa de pós-processamento nesse rastreamento para gerar o arquivo especificado pelo <outputFile> parâmetro.

A /templates opção inclui eventos de instância de modelo no ficheiro caso o rastreio tenha sido iniciado com /level3.

(1) Gera um ficheiro visível no Windows Analisador de Desempenho (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 utilizador atual permissão para iniciar e parar sessões de rastreamento vcperf que usam /noadmin sem elevação. Execute vcperf /grantusercontrol a partir de uma linha de comandos elevada uma vez por utilizador em cada máquina. A amostragem da CPU ainda requer um rastreio com privilégios elevados sem /noadmin. O comando foi adicionado na versão vcperf 2.5.25121101.

Rastreamento sem privilégios de administrador

Numa linha de comandos elevada, conceda ao utilizador atual permissão para controlar sessões de rastreio:

vcperf /grantusercontrol

Numa linha de comandos sem elevação, inicie um rastreamento:

vcperf /start /noadmin MySession

Construa o seu projeto e depois pare o rastreio a partir de uma linha de comandos sem elevação:

vcperf /stop MySession output.etl

Ver também

Comece com o C++ Build Insights
Tutorial: Windows Analisador de Desempenho noções básicas
Referência: Windows Analisador de Desempenho vistas
Windows Analisador de Desempenho