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