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*****