Referenz: vcperf-Befehle
Die C++-Buildeinblick-Tools sind ab Visual Studio 2019 und höher verfügbar. Um die Dokumentation für diese Version anzuzeigen, legen Sie das Visual Studio-Versionsauswahlsteuerelement für diesen Artikel auf Visual Studio 2019 oder höher fest. Es befindet sich am Anfang des Inhaltsverzeichnisses auf dieser Seite.
In diesem Artikel werden die verfügbaren vcperf.exeBefehle und deren Verwendung aufgelistet und beschrieben.
Befehle zum Starten und Beenden von Ablaufverfolgungen
Wichtig
Sofern Sie nicht angeben /noadmin, benötigen die folgenden Befehle Administratorrechte.
| Option | Argumente und Beschreibung |
|---|---|
/start |
[/noadmin] [/nocpusampling] [/level1 | /level2 | /level3] <sessionName> |
| Startet eine Ablaufverfolgung unter dem angegebenen Sitzungsnamen. Die /noadmin Option führt vcperf.exe ohne Administratorrechte aus und ignoriert die /nocpusampling Option. Wenn Sie vcperf ohne Administratorrechte ausführen, kann es mehrere aktive Sitzungen auf einem bestimmten Computer geben. Die /nocpusampling Option gibt vcperf.exe keine CPU-Proben an. Der Befehl verhindert die Verwendung der Ansicht „CPU-Auslastung (Stichproben)“ in Windows Performance Analyzer, verkleinert aber die gesammelten Ablaufverfolgungen. Die /level1, /level2oder /level3 Optionen geben an, welche MSVC-Ereignisse erfasst werden sollen, bei zunehmender Informationsstufe. Stufe 3 enthält alle Ereignisse. Ebene 2 enthält alle Ereignisse mit Ausnahme von Vorlageninstanziierungsereignissen. Ebene 1 enthält alle Ereignisse außer Vorlageninstanziierung, Funktion und Dateiereignissen. Wenn nicht angegeben, /level2 ist standardmäßig aktiviert. Sobald vcperf.exe die Spur startet, wird sie sofort zurückgegeben. Die Ablaufverfolgung erfasst Ereignisse systemweit für alle Prozesse, die auf dem Computer ausgeführt werden. Das bedeutet, dass Sie Ihr Projekt nicht in demselben Eingabeaufforderungsfenster erstellen müssen, das Sie zum Ausführen von vcperf.exe verwenden. Sie können ihr Projekt beispielsweise in Visual Studio erstellen. |
|
/stop |
(1) [/templates] <sessionName> <outputFile.etl> (2) [ /templates] <sessionName> /timetrace <outputFile.json> |
Beendet die Ablaufverfolgung, die durch den angegebenen Sitzungsnamen identifiziert wird. Führt einen Schritt nach der Verarbeitung der Ablaufverfolgung aus, um eine durch den <outputFile> Parameter angegebene Datei zu generieren. Die /templates Option enthält Vorlageninstanziierungsereignisse in der Datei. (1) Generiert eine Datei, die in Windows Leistungsanalyse (WPA) angezeigt werden kann. Für die Ausgabedatei ist eine .etl Erweiterung erforderlich.(2) Generiert eine Datei, die im Microsoft Edge-Ablaufverfolgungs-Viewer ( edge://tracing) angezeigt werden kann. Für die Ausgabedatei ist eine .json Erweiterung erforderlich. |
|
/stopnoanalyze |
<sessionName> <rawOutputFile.etl> |
| Beendet die Ablaufverfolgung, die durch den angegebenen Sitzungsnamen identifiziert wird, und schreibt die nicht verarbeiteten Rohdaten in die angegebene Ausgabedatei. Die resultierende Datei ist nicht für die Anzeige in WPA vorgesehen. Der im Befehl /stop integrierte Nachverarbeitungsschritt kann u. U. sehr lange dauern. Sie können den Befehl /stopnoanalyze verwenden, um diesen Schritt zu verschieben. Verwenden Sie den /analyze Befehl, wenn Sie bereit sind, eine Datei zu erstellen, die in Windows Leistungsanalyse oder dem Microsoft Edge-Ablaufverfolgungs-Viewer angezeigt werden kann. |
Verschiedene Befehle
| Option | Argumente und Beschreibung |
|---|---|
/analyze |
(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [ /templates] <rawInputFile.etl> /timetrace <outputFile.json> |
Akzeptiert eine unformatierte Ablaufverfolgungsdatei, die vom Befehl /stopnoanalyze erzeugt wird. Führt einen Schritt nach der Verarbeitung dieser Ablaufverfolgung aus, um die durch den <outputFile> Parameter angegebene Datei zu generieren. Die /templates Option enthält Vorlageninstanziierungsereignisse in der Datei. (1) Generiert eine Datei, die in Windows Leistungsanalyse (WPA) angezeigt werden kann. Für die Ausgabedatei ist eine .etl Erweiterung erforderlich. (2) Generiert eine Datei, die im Microsoft Edge-Ablaufverfolgungs-Viewer ( edge://tracing) angezeigt werden kann. Für die Ausgabedatei ist eine .json Erweiterung erforderlich. |
Siehe auch
Erste Schritte mit C++ Build Insights
Lernprogramm: Grundlagen von Windows Leistungsanalyse
Referenz: Windows Leistungsanalyse-Ansichten
Windows Performance Analyzer