Condividi tramite

Esercitazione: vcperf e Windows analizzatore prestazioni

  • Articolo

Gli strumenti di Build Insights per C++ sono disponibili in Visual Studio 2019 e versioni successive. Per visualizzare la documentazione per questa versione, impostare il controllo selettore della versione di Visual Studio per questo articolo su Visual Studio 2019 o versione successiva. Si trova nella parte superiore del sommario in questa pagina.

In questa esercitazione si apprenderà come usare vcperf.exe per raccogliere una traccia della compilazione C++. Si apprenderà anche come visualizzare questa traccia in Windows analizzatore prestazioni.

Passaggio 1: Installare e configurare Windows analizzatore prestazioni

WPA è un visualizzatore di traccia disponibile in Windows Assessment and Deployment Kit (ADK). Si tratta di un'utilità separata che non fa parte dei componenti che è possibile installare con il programma di installazione di Visual Studio.

Una versione di WPA che supporta Build Insights C++ è disponibile solo nelle versioni di Windows ADK numerate 10.1.19041.0 o successive.

Per scaricare e installare WPA

NOTA: Windows 8 o versione successiva è necessario per l'installazione di Windows analizzatore prestazioni.

  1. Passare alla pagina di download di Windows ADK.

  2. Scaricare e installare la versione più recente di Windows ADK.

  3. Quando vengono richieste le funzionalità da installare, selezionare Windows Performance Toolkit. È possibile selezionare altre funzionalità se si desidera, ma non sono necessarie per installare WPA.

    Schermata di selezione delle funzionalità del programma di installazione di Windows analizzatore prestazioni.

Per configurare WPA

La visualizzazione delle tracce di Build Insights in C++ in WPA richiede un componente aggiuntivo speciale. Per installarlo, seguire questa procedura:

  1. Ottenere il componente aggiuntivo scaricando uno dei componenti seguenti. Non è necessario ottenere entrambi. Scegli quello che trovi più comodo.

    • Visual Studio 2019 versione 16.6 e successive. Per la versione più recente, vedere Download di Visual Studio.
    • Pacchetto NuGet di Build Insights per C++.

  2. Copiare il perf_msvcbuildinsights.dll file nella directory di installazione wpa.

    1. In Visual Studio 2019 versione 16.6 e successive questo file si trova qui: C:\Program Files (x86)\Microsoft Visual Studio\{Year}\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture}.
    2. Nel pacchetto NuGet build Insights C++ questo file si trova qui: wpa\{Architecture}.
    3. Nei percorsi precedenti sostituire le variabili racchiuse tra parentesi graffe come indicato di seguito:
      1. {Year} è l'anno del prodotto Visual Studio, ad esempio 2019 o 2022.
      2. {Edition} è l'edizione di Visual Studio, ad esempio Community, Professional o Enterprise.
      3. {Version} è la versione MSVC. Scegliere quello più alto disponibile.
      4. {Architecture}: scegliere x64 se si dispone di una versione a 64 bit di Windows. In caso contrario, scegliere x86.
    4. La directory di installazione wpa è in genere: C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit.

  3. Nella directory di installazione wpa aprire il perfcore.ini file e aggiungere una voce per perf_msvcbuildinsights.dll.

Passaggio 2: Tracciare la compilazione con vcperf.exe

Per visualizzare i dati di C++ Build Insights, prima di tutto raccoglierli in un file di traccia seguendo questa procedura:

  1. Aprire un prompt dei comandi degli strumenti nativi x64 o x86 per Visual Studio in modalità amministratore. Fare clic con il pulsante destro del mouse sull'elemento menu Start e scegliere Altro>Esegui come amministratore.

    1. Scegliere x64 se si dispone di una versione a 64 bit di Windows. In caso contrario, scegliere x86.

  2. Nella finestra del prompt dei comandi immettere questo comando:

    vcperf.exe /start SessionName

    Scegliere un nome di sessione da ricordare per SessionName.

  3. Compilare il progetto come si farebbe normalmente. Non è necessario usare la stessa finestra del prompt dei comandi per la compilazione.

  4. Nella finestra del prompt dei comandi immettere questo comando:

    vcperf.exe /stop SessionNametraceFile.etl

    Usare lo stesso nome di sessione scelto per SessionName in precedenza. Scegliere un nome appropriato per il file di traccia traceFile.etl .

Ecco l'aspetto tipico di una sequenza di comandi vcperf.exe in una finestra del prompt dei comandi per gli sviluppatori:

Screenshot di una finestra di comando che mostra vcperf.exe comandi e risultati.

Note importanti su vcperf.exe

  • Per avviare o arrestare una traccia vcperf.exe sono necessari privilegi di amministratore. Usare una finestra del prompt dei comandi per gli sviluppatori aperta usando Esegui come amministratore.

  • In un computer può essere eseguita una sola sessione di traccia alla volta.

  • Assicurarsi di ricordare il nome della sessione usato per avviare la traccia. Può essere problematico arrestare una sessione in esecuzione senza conoscerne il nome.

  • Proprio come cl.exe e link.exe, l'utilità della riga di comando vcperf.exe è inclusa in un'installazione MSVC. Non sono necessari passaggi aggiuntivi per ottenere questo componente.

  • vcperf.exe raccoglie informazioni su tutti gli strumenti MSVC in esecuzione nel sistema. Di conseguenza, non è necessario avviare la compilazione dallo stesso prompt dei comandi usato per raccogliere la traccia. È possibile compilare il progetto da un prompt dei comandi diverso o anche in Visual Studio.

vcperf.exe è open source

Se si vuole compilare ed eseguire la propria versione di vcperf.exe, è possibile clonarla dal repository GitHub vcperf.

Passaggio 3: Visualizzare la traccia in Windows analizzatore prestazioni

Avviare WPA e aprire la traccia appena raccolta. WPA deve riconoscerlo come traccia di Build Insights in C++ e le visualizzazioni seguenti dovrebbero essere visualizzate nel pannello Graph Explorer a sinistra:

  • Esplora compilazioni
  • File
  • Funzioni
  • Creazione di istanze di modelli

Se non è possibile visualizzare queste visualizzazioni, verificare che WPA sia configurato correttamente, come descritto nel passaggio 1. È possibile visualizzare i dati di compilazione trascinando le visualizzazioni nella finestra Analisi vuota a destra, come illustrato di seguito:

Visualizzazione di una traccia di C++ Build Insights in Windows analizzatore prestazioni.

Altre visualizzazioni sono disponibili nel pannello Graph Explorer. Trascinarli nella finestra Analisi quando si è interessati alle informazioni che contengono. Uno utile è la visualizzazione CPU (campionata), che mostra l'utilizzo della CPU durante la compilazione.

Ulteriori informazioni

Esercitazione: Nozioni di base su Windows analizzatore prestazioni
Informazioni sulle operazioni WPA comuni che consentono di analizzare le tracce di compilazione.

Riferimento: comandi vcperf
Il riferimento al comando vcperf.exe elenca tutte le opzioni di comando disponibili.

Riferimento: Visualizzazioni di Windows analizzatore prestazioni
Fare riferimento a questo articolo per informazioni dettagliate sulle visualizzazioni di Build Insights di C++ in WPA.

Windows Performance Analyzer
Sito ufficiale della documentazione WPA.