Condividi tramite


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.exee 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 /level1opzioni , /level2o /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