Tutorial: vcperf e Windows Performance Analyzer

As ferramentas C++ Build Insights estão disponíveis no Visual Studio 2019 e posterior. Para ver a documentação desta versão, defina o controle do selector de versão do Visual Studio para este artigo como Visual Studio 2019 ou posterior. Encontra-se na parte superior do índice desta página.

Neste tutorial, você aprenderá como usar vcperf.exe para coletar um rastreamento de sua compilação C++. Você também aprenderá a exibir esse rastreamento no Analisador de Desempenho do Windows.

Etapa 1: Instalar e configurar o Analisador de Desempenho do Windows

WPA é um visualizador de rastreamento disponível no Kit de Avaliação e Implantação do Windows (ADK). É um utilitário separado que não faz parte dos componentes que você pode instalar com o instalador do Visual Studio.

Uma versão do WPA que suporta C++ Build Insights só está disponível em versões do Windows ADK numeradas 10.1.19041.0 ou posterior.

Para baixar e instalar o WPA

NOTA: O Windows 8 ou superior é necessário para instalar o Analisador de Desempenho do Windows.

1. Navegue até a página de download do Windows ADK.

2. Transfira e instale a versão mais recente do Windows ADK.

3. Quando for solicitado os recursos que você deseja instalar, selecione o Kit de Ferramentas de Desempenho do Windows. Você pode selecionar outros recursos, se desejar, mas eles não são necessários para instalar o WPA.

   

Para configurar o WPA

A visualização de rastreamentos do C++ Build Insights no WPA requer um suplemento especial. Siga estes passos para instalá-lo:

1. Obtenha o suplemento baixando um dos componentes abaixo. Você não precisa obter os dois. Escolha o que achar mais conveniente.

   • Visual Studio 2019 versão 16.6 e superior. Para obter a versão mais recente, consulte Downloads do Visual Studio.
   • Pacote NuGet do C++ Build Insights.

2. Copie o ficheiro perf_msvcbuildinsights.dll para o diretório de instalação do WPA.

   1. No Visual Studio 2019 versão 16.6 e superior, este arquivo está localizado aqui: C:\Program Files (x86)\Microsoft Visual Studio\{Year}\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture}.
   2. No pacote NuGet do C++ Build Insights, esse arquivo está localizado aqui: wpa\{Architecture}.
   3. Nos caminhos acima, substitua as variáveis cercadas por colchetes da seguinte maneira:
      1. {Year} é o ano do produto Visual Studio, como 2019 ou 2022.
      2. {Edition} é sua edição do Visual Studio, como Community, Professional ou Enterprise.
      3. {Version} é a sua versão do MSVC. Escolha o mais alto disponível.
      4. {Architecture}: escolha x64 se você tem uma versão de 64 bits do Windows. Caso contrário, escolha x86.
   4. O diretório de instalação do WPA é normalmente: C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit.

3. No diretório de instalação do WPA, abra o perfcore.ini arquivo e adicione uma entrada para perf_msvcbuildinsights.dll.

Etapa 2: Rastreia a tua construção com vcperf.exe

Para exibir dados do C++ Build Insights, primeiro colete-os em um arquivo de rastreamento seguindo estas etapas:

1. Abra um prompt de comando de ferramentas nativas x64 ou x86 para VS no modo de administrador. (Clique com o botão direito do mouse no item do menu Iniciar e escolha Mais>Executar como administrador.)

   1. Escolha x64 se tiver uma versão de 64 bits do Windows. Caso contrário, escolha x86.

2. Na janela do prompt de comando, digite este comando:

   vcperf.exe /start SessionName

   Escolha um nome de sessão que você se lembrará para SessionName.

3. Construa seu projeto como faria normalmente. Você não precisa usar a mesma janela de prompt de comando para construir.

4. Na janela do prompt de comando, digite este comando:

   vcperf.exe /stop SessionNametraceFile.etl

   Use o mesmo nome de sessão que você escolheu para SessionName antes. Escolha um nome apropriado para o arquivo de rastreamento traceFile.etl .

Veja a aparência de uma sequência de comandos vcperf.exe típica em uma janela de prompt de comando do desenvolvedor:

Observações importantes sobre vcperf.exe

• Os privilégios de administrador são necessários para iniciar ou interromper um rastreamento devcperf.exe . Use uma janela de prompt de comando do desenvolvedor que você abre usando Executar como administrador.

• Apenas uma sessão de rastreamento de cada vez pode ser executada em uma máquina.

• Lembre-se do nome da sessão que você usou para iniciar o rastreamento. Pode ser problemático parar uma sessão em execução sem saber o seu nome.

• Assim como cl.exe e link.exe, o utilitário de linha de comandovcperf.exe está incluído em uma instalação MSVC. Não são necessárias etapas adicionais para obter este componente.

• vcperf.exe coleta informações sobre todas as ferramentas MSVC em execução no seu sistema. Como resultado, você não precisa iniciar sua compilação a partir do mesmo prompt de comando usado para coletar o rastreamento. Você pode criar seu projeto a partir de um prompt de comando diferente ou até mesmo no Visual Studio.

vcperf.exe é de código aberto

Se você deseja construir e executar sua própria versão do vcperf.exe, sinta-se à vontade para cloná-lo do repositório vcperf GitHub.

Etapa 3: Exibir seu rastreamento no Analisador de Desempenho do Windows

Inicie o WPA e abra o rastreamento que você acabou de coletar. O WPA deve reconhecê-lo como um registo do C++ Build Insights, e as seguintes vistas devem aparecer no painel Graph Explorer à esquerda.

• Explorador de Build
• Ficheiros
• Funções
• Instanciações de modelo

Se não conseguir ver estas vistas, verifique se o WPA está configurado corretamente, conforme descrito no Passo 1. Pode visualizar os seus dados de compilação arrastando as visualizações para a janela de Análise vazia à direita, conforme se vê aqui:

Outras visualizações estão disponíveis no painel Graph Explorer. Arraste-os para a janela Análise quando estiver interessado nas informações que eles contêm. Uma visualização útil é a vista CPU (Amostrada), que mostra a utilização da CPU durante a sua compilação.

Mais informações

Tutorial: Noções básicas do Analisador de Desempenho do Windows
Saiba mais sobre operações comuns de WPA que podem ajudá-lo a analisar os seus registos de compilação.

Referência: comandos vcperf
A referência de comandovcperf.exe lista todas as opções de comando disponíveis.

Referência: visualizações do Analisador de Desempenho do Windows
Consulte este artigo para obter detalhes sobre as visualizações do C++ Build Insights no WPA.

Analisador de Desempenho do Windows
O site oficial de documentação WPA.