VSPerfReport
Aktualisiert: November 2007
Mit dem Befehlszeilentool VSPerfReport können Sie unter Verwendung von Visual Studio Team System Developer Edition-Profilerstellungstools-Profilerstellungsdaten 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.
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 |
Beschreibung |
---|---|
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 – Bericht enthält Beziehungen zwischen übergeordneten und untergeordneten Funktionen. Function – Bericht enthält aufgerufene Funktionen. Module - Bericht enthält überwachte Module. CallTree – Bericht enthält Hierarchie der aufgerufenen Funktionen. Thread – Bericht enthält überwachte Threads. Process – Bericht enthält überwachte Prozesse. Type – Bericht enthält zugeordnete Typen. Header – Bericht enthält Dateiheaderinformationen. Mark – Bericht enthält alle Markierungen. Counter – Bericht enthält alle Markierungen zusammen mit Indikatorwerten. Ip – Bericht enthält überwachte Anweisungsdaten. Life – Bericht enthält Lebensdauer zugeordneter Objekte (nach der Erfassung von Zuordnungsdaten verfügbar). Line – Bericht enthält Profildaten zu Quellcodezeilen. |
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 gepackte Symbole aus einer Berichtsdatei. |
SYMBOLPATH:path |
Speicherort von Symbolen. |
DEBUGSYMPATH |
Führt auf, welche Speicherorte nach Symbolen durchsucht werden. |
PACKSYMBOLS |
Packt die Symbole nach der Analyse in die Berichtsdatei. |
OUTPUT:path|filename |
Speicherort der Berichtdatei. |
SUMMARYFILEe |
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. |
PRINTMARKS |
Bericht enthält die Namen und Timestamps für alle Markierungen. |
? |
Zeigt Verwendungsinformationen an. |
NOLOGO |
Blendet Versionsinformationen aus, wenn der Bericht ausgeführt wird. |
Filteroptionen
In der folgenden Tabelle werden die Optionen zum Filtern der verfügbaren Daten beschrieben.
Optionen |
Beschreibung |
---|---|
STARTTIME:[value] |
Zeigt nur nach einem Wert (in Millisekunden) erfasste Daten an. |
ENDTIME:[value] |
Zeigt nur vor einem Wert (in Millisekunden) erfasste Daten an. |
MSFILTER:[starttime,duration] |
Zeigt nur Daten von STARTTIME bis zum Ende der Zeitdauer (in Millisekunden) an. |
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 |
Beschreibung |
---|---|
DIFF |
Vergleicht zwei Berichtsdateien (.vsp oder .vsps). Zusammenfassungsoptionen werden mit der diff-Option ignoriert. |
DIFFTHRESHOLD:[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
Referenz
Definitionen der Spalten in den Berichten der Profilerstellungstools