VSPerfReport

Mit dem Befehlszeilentool VSPerfReport können Sie unter Verwendung von Profilerstellungsdatendateien der Visual Studio-Profilerstellungstools Berichte erstellen. Das Standardberichtsformat entspricht einer .csv-Datei.

VSPerfReport verwendet die folgende Syntax:

VSPerfReport [/U] vspfilename [/options]

Beachten Sie, dass filename eine gültige .vsp- oder .vsps-Datei sein muss.

Das Befehlszeilentool VSPerfReport wird auch zum Vergleichen von VSP- oder VSPS-Dateien verwendet. Um einen Unterschiedsbericht ("diff") zu generieren, verwenden Sie die folgende Syntax:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]

vspfilename1 and vspfilename2 müssen gültige .vsp- oder .vsps-Dateien sein.

Symboldateien

Um Symbolinformationen, wie z. B. Funktionsnamen und Zeilennummern, anzuzeigen, benötigt VSPerfReport Zugriff auf die Symboldateien (.PDB) der profilierten Komponenten und auf die Windows-Symboldateien. Weitere Informationen finden Sie unter Gewusst wie: Angeben von Symboldateispeicherorten über die Befehlszeile.

Allgemeine Berichtsoptionen

In der folgenden Tabelle werden die allgemeinen Optionen der Berichtsformatierung sowie die Optionen für die Auswahl der Daten beschrieben, auf deren Grundlage ein Bericht erstellt wird.

Optionen	Beschreibungen
U	Berichtsausgabe und umgeleitete Konsolenausgabe werden als Unicode geschrieben. Muss die erste angegebene Option sein.
Summary:[types]	Erstellt mindestens einen Berichtstyp. All – Alle Berichtstypen werden generiert. CallerCallee – Über- und untergeordnete Beziehungen zwischen Funktionen. Function – Aufgerufene Funktionen. CallTree – Hierarchie der aufgerufenen Funktionen. Counter – Alle Markierungen zusammen mit Windows-Leistungsindikatorwerten. Ip – Profilierte Anweisungen. Life – Lebensdauer belegter Objekte (verfügbar, sofern Speicherbelegungsdaten gesammelt wurden). Line – Profildaten zu Quellcodezeilen. Header – Bericht enthält Dateiheaderinformationen. Mark – Alle Markierungen. Module – Profilierte Module. Process – Profilierte Prozesse. Thread – Profilierte Threads. Type – Belegte Typen. Contention – Ressourcenkonflikte. RuleWarnings – Leistungsregelprobleme ETW – Alle während der Profilerstellungsausführung erfassten Ereignisse der Ereignisablaufverfolgung für Windows (ETW). Die ETL-Datendatei muss an ihrem ursprünglichen Speicherort oder in dem Verzeichnis abgelegt sein, das die VSP- oder VSPS-Datei enthält.
Xml	Ausgabe des Berichts im XML-Format.
CallTrace	Erstellt eine Liste mit Werten für den Eintritt in bzw. das Verlassen von Funktionen, ETW-Ereignissen und Markierungen.
ClearPackedSymbols	Entfernt zuvor eingebettete Symbole aus einer Profilerdatendatei. Führen Sie diesen Befehl aus, bevor Sie PackSymbols erneut ausführen.
SymbolPath:path	Gibt einen oder mehr Suchpfade oder Symbolserver an, die Symbole für die Profilerdatendatei enthalten.
DebugSymPath	Listet die Speicherorte, in denen nach Symbolen gesucht wird, und Hinweise zu gefundenen Symbole auf. Diese Option ist hilfreich, um Symbolauflösungsprobleme zu beheben.
PackSymbols	Speichert Symbole in der Profilerstellungs-Datendatei (.vsp), damit Symboldateien (.pdb) für die Analyse nicht erforderlich sind.
Output:path|filename	Gibt einen alternativen Speicherort für die generierten Berichtdateien an. Standardmäßig werden Berichte im aktuellen Verzeichnis erstellt.
SummaryFile	Analysiert und speichert die analysierten Informationen in einer .vsps-Zusammenfassungsdatei.
PrintMarks	Zeigt die Namen und Timestamps für alle Markierungen in der angegebenen Berichtsdatei an.
?	Zeigt Verwendungsinformationen an.
NoLogo	Blendet Versionsinformationen aus, wenn der Bericht ausgeführt wird.
UserRulesDirectory	Gibt das Verzeichnis an, das benutzerdefinierte Leistungsregeln enthält [Noch nicht implementiert].

Filteroptionen

In der folgenden Tabelle werden die Optionen zum Filtern der verfügbaren Daten beschrieben.

Optionen	Beschreibungen
JustMyCode[:[caller][,callee]]	Nur Funktionsaufrufe durch Benutzeranwendungen zeigen; Systemaufrufe ausblenden. Keine Parameter – Alle Systemfunktionen ausblenden. caller – Eine Ebene von Systemfunktionen anzeigen, die Anwendungsfunktionen aufrufen. callee – Eine Ebene von Systemfunktionen anzeigen, die von Benutzeranwendungsfunktionen aufgerufen werden.
StartTime:[Wert]	Zeigt nur nach einem Wert (in Millisekunden) erfasste Daten an.
EndTime:[Wert]	Zeigt nur vor einem Wert (in Millisekunden) erfasste Daten an.
FilterFile:VSPFFile	Gibt den Speicherort einer Filterdatei an, die im Visual Studio-Fenster Leistungsbericht generiert wurde.
MsFilter:[starttime,duration]	Nur Daten ab starttime und für die Dauer von duration (in Millisekunden) anzeigen.
Process:[pid]	Zeigt nur Daten zum angegebenen Prozess an.
Thread:[threadid]	Zeigt nur Daten zum angegebenen Thread an.
Thread:[threadid, processid]	Zeigt nur Daten zum angegebenen Thread an, der mit dem angegebenen Prozess verknüpft ist.

Optionen für Unterschiedsberichte

In der folgenden Tabelle werden die Optionen zum Vergleichen von Berichtsdateien beschrieben.

Optionen	Beschreibungen
Diff vspfile1 vspfile2	Vergleicht zwei Berichtsdateien (.vsp oder .vsps). Zusammenfassungsoptionen werden mit der diff-Option ignoriert.
Diff:[value]	Unterschiede zwischen zwei Werten, die unter diesem Schwellenwert liegen, werden ignoriert. Außerdem werden auch keine neuen Daten mit Werten unter diesem Schwellenwert angezeigt.
DiffTable:[tablename]	Verwendet diese bestimmte Tabelle, um Dateien zu vergleichen. Standardmäßig wird die Funktionstabelle verwendet.
DiffColumn:[columnname]	Verwendet diese bestimmte Spalte, um Werte zu vergleichen. Standardmäßig wird die Spalte mit dem prozentualen Wert der exklusiven Samplings verwendet.
QueryDiffTables	Listet die gültigen Tabellen und Spalten für die beiden bereitgestellten Berichtsdateien auf.

Siehe auch

Weitere Ressourcen

Berichtsansichten für Profilerstellungstools