Riferimento: comandi vcperf
Gli strumenti di Build Insights per C++ sono disponibili a partire da Visual Studio 2019 e versioni successive. Per visualizzare la documentazione per tale 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.
Questo articolo elenca e descrive i comandi disponibili in vcperf.exe
e come usarli.
Comandi per avviare e arrestare le tracce
Importante
A meno che non si specifichi /noadmin
, i comandi seguenti richiedono privilegi amministrativi.
Opzione | Argomenti e descrizione |
---|---|
/start |
[] [/noadmin ] [] [/level1 | | /level2 /level3 ]/nocpusampling <sessionName> |
Avvia una traccia sotto il nome della sessione specificato. L'opzione /noadmin esegue vcperf.exe senza privilegi di amministratore e ignora l'opzione /nocpusampling . Quando si esegue vcperf senza privilegi di amministratore, è possibile che in un computer specifico siano presenti più sessioni attive. L'opzione /nocpusampling specifica vcperf.exe non raccoglie esempi di CPU. Impedisce l'uso della visualizzazione Utilizzo CPU (campionato) in Windows analizzatore prestazioni, ma rende le tracce raccolte più piccole. Le /level1 opzioni , /level2 o /level3 specificano gli eventi MSVC da raccogliere, aumentando il livello di informazioni. Il livello 3 include tutti gli eventi. Il livello 2 include tutti gli eventi ad eccezione degli eventi di creazione di istanze del modello. Il livello 1 include tutti gli eventi tranne la creazione di istanze del modello, la funzione e gli eventi di file. Se non specificato, /level2 è selezionato per impostazione predefinita. Quando vcperf.exe avvia la traccia, viene restituita immediatamente. La traccia raccoglie gli eventi a livello di sistema per tutti i processi in esecuzione nel computer. Ciò significa che non è necessario compilare il progetto nella stessa finestra del prompt dei comandi di quello usato per eseguire vcperf.exe. Ad esempio, è possibile compilare il progetto in Visual Studio. |
|
/stop |
(1) [/templates ] <sessionName> <outputFile.etl> (2) [ /templates ] <sessionName> /timetrace <outputFile.json> |
Arresta la traccia identificata dal nome della sessione specificato. Esegue un passaggio di post-elaborazione sulla traccia per generare un file specificato dal <outputFile> parametro . L'opzione /templates include eventi di creazione di istanze del modello nel file. (1) Genera un file visualizzabile in Windows analizzatore prestazioni (WPA). Il file di output richiede un'estensione .etl .(2) Genera un file visualizzabile nel visualizzatore di traccia di Microsoft Edge ( edge://tracing ). Il file di output richiede un'estensione .json . |
|
/stopnoanalyze |
<sessionName> <rawOutputFile.etl> |
Arresta la traccia identificata dal nome della sessione specificato e scrive i dati non elaborati nel file di output specificato. Il file risultante non è destinato alla visualizzazione in WPA. Il passaggio di post-elaborazione coinvolto nel /stop comando può talvolta essere lungo. È possibile usare il /stopnoanalyze comando per ritardare questo passaggio di post-elaborazione. Usare il /analyze comando quando si è pronti per produrre un file visualizzabile in Windows analizzatore prestazioni o nel visualizzatore di traccia di Microsoft Edge. |
Comandi vari
Opzione | Argomenti e descrizione |
---|---|
/analyze |
(1) [/templates ] <rawInputFile.etl> <outputFile.etl> (2) [ /templates ] <rawInputFile.etl> /timetrace <outputFile.json> |
Accetta un file di traccia non elaborato generato dal /stopnoanalyze comando . Esegue un passaggio di post-elaborazione in questa traccia per generare il file specificato dal <outputFile> parametro . L'opzione /templates include eventi di creazione di istanze del modello nel file. (1) Genera un file visualizzabile in Windows analizzatore prestazioni (WPA). Il file di output richiede un'estensione .etl . (2) Genera un file visualizzabile nel visualizzatore di traccia di Microsoft Edge ( edge://tracing ). Il file di output richiede un'estensione .json . |
Vedi anche
Introduzione a C++ Build Insights
Esercitazione: Nozioni di base su Windows analizzatore prestazioni
Riferimento: Visualizzazioni di Windows analizzatore prestazioni
Windows Performance Analyzer