Partilhar via

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] [/level1 | /level2 | /level3] <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.

Assim que vcperf.exe inicia o rastreamento, ele retorna imediatamente. O rastreamento coleta eventos em todo o sistema para todos os processos em execução na máquina. 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.
/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 instanciação de modelo no arquivo.

(1) Gera um ficheiro 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 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 instanciação de modelo no arquivo.

(1) Gera um ficheiro 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.

Ver também

Introdução ao C++ Build Insights
Tutorial: Noções básicas do Analisador de Desempenho do Windows
Referência: visualizações do Analisador de Desempenho do Windows
Analisador de Desempenho do Windows

  • Last updated on