Freigeben über


TraceView -process

Verwenden Sie den Befehl TraceView -process, um die binären Trace-Meldungen in einem Trace-Protokoll oder aus einem Echtzeit-Trace zu formatieren. Der Befehl TraceView -process erstellt eine Textdatei mit Trace-Meldungen und eine Zusammenfassungsdatei, die die Eingabe- und Ausgabedateien beschreibt.

    traceview -process [EtlFile | -rt SessionName][Parameters]
   

Parameter

EtlFile
Gibt die Datei des Ereignisprotokolls (.etl) an, die die Trace-Meldungen enthält. Geben Sie den Pfad (optional) und den Dateinamen ein. Die Standardeinstellung ist c:\logfile.etl.

-Rt SessionName
In Echtzeit. Formatiert Trace-Meldungen aus den angegebenen Echtzeit-Trace-Sitzungen.

SessionName ist der Name der Trace-Session. Wenn Sie den Namen der Trace-Session weglassen, formatiert Tracefmt die Meldungen der Trace-Session NT Kernel Logger.

-tmf TMFFile
Gibt den Pfad (optional) und den Dateinamen der Datei trace message format (.tmf) für die Trace-Meldungen an.

-p TMFPath
Gibt den Pfad zu dem Verzeichnis an, das die Datei trace message format (.tmf) für die Trace-Meldungen enthält.

-o OutputFile
Gibt einen Namen für die Ausgabedateien an. Dieser Name gilt für die Textdatei der formatierten Trace-Meldungen und für eine Zusammenfassungsdatei.

OutputFile ist ein Pfad und ein Dateiname mit einer .txt-Erweiterung, z. B. c:\traces\trace.txt. Die Standardwerte sind FmfFile.txt und FmtSum.txt im lokalen Verzeichnis.

Wenn Sie diesen Parameter mit dem Parameter -displayonly oder -summaryonly verwenden, wirkt er sich nur auf die Zusammenfassungsdatei aus.

-csv
Formatiert das Trace-Protokoll als kommagetrennte Datei variabler Länge (.csv).

-zeigen
Zeigt die Trace-Meldungen im Eingabeaufforderungsfenster an und schreibt sie zusätzlich in die Ausgabedatei.

-displayonly
Zeigt die Trace-Meldungen nur im Eingabeaufforderungsfenster an. TraceView erstellt keine Textdatei mit Trace-Meldungen.

-nosummary
Es wird keine Kurzmeldungsdatei erstellt.

-summaryonly
Erstellt nur eine Kurznachrichtendatei. Tracefmt erstellt keine Ausgabedatei.

-noprefix
Lässt das Trace Message Prefix aus. Dieser Parameter beeinflusst die Trace-Meldungen in der Ausgabedatei und die Tracefmt-Anzeige.

-Ods
Sendet die formatierten Trace-Meldungen zur Anzeige an den Debugger.

-v
Verbose. Zeigt detaillierte Informationen im Eingabeaufforderungsfenster an, während Tracefmt jeden Block oder Puffer von Trace-Meldungen verarbeitet. Verwenden Sie diesen Parameter, wenn Sie vermuten, dass die Datei beschädigt ist oder Inkonsistenzen aufweist.

-h | /?
Zeigt die Hilfe an.

Beispiele

traceview -process
traceview -process mytrace.etl -p c:\tracing -o mytrace.txt
traceview mytrace.etl -tmf c:\tracing\37753236-c81f-505e-d40a-128d3bb2b5ff.tmf
tracefmt -rt MyTrace -p c:\tracing -o mytrace.txt -display

Kommentare

Um Trace-Meldungen zu formatieren, müssen Sie eine Trace-Meldungsformatdatei für die Trace-Meldungen angeben. Die verfügbaren Methoden sind in der Reihenfolge ihres Vorrangs aufgeführt:

  • Der Parameter -tmf .

  • Der Parameter -p .

  • Die Umgebungsvariable %TRACE_FORMAT_SEARCH_PATH%. Setzt den Wert der Variablen auf das Verzeichnis, in dem sich die TMF-Datei befindet.

Wenn der TMF-Dateiname keine Nachrichten-GUID ist, verwenden Sie den Parameter -tmf und geben Sie den voll qualifizierten Pfad zu der Datei ein. Andernfalls wird TraceView die TMF-Datei nicht finden.

Wenn TraceView eine TMF-Datei nicht finden kann oder die TMF-Datei keine Formatierungsinformationen für die Trace-Meldungen enthält, kann TraceView die Meldungen nicht formatieren. Stattdessen schreibt TraceView anstelle des Nachrichtentextes: "Keine Formatinformationen gefunden"

Wenn TraceView eine Trace-Meldung nicht formatieren kann, löst es eine Ausnahme aus und zeigt eine Meldung wie z.B.:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****