TraceView -process

使用 TraceView -process 命令来格式化跟踪日志或实时跟踪 Seeion 中的二进制跟踪消息。 该 TraceView -process 命令会创建一个跟踪消息文本文件和一个描述输入和输出文件的摘要文件。

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

参数

EtlFile
指定包含跟踪消息的事件跟踪日志 (.etl) 文件。 输入路径（可选）和文件名。 默认值为 c:\logfile.etl。

-rt SessionName
实时。 格式化指定实时跟踪会话的跟踪信息。

SessionName 是跟踪会话的名称。 如果省略跟踪会话名称，Tracefmt 会格式化来自 NT 内核记录器跟踪会话的信息。

-tmf TMFFile
指定跟踪信息格式 (.tmf) 文件的路径（可选）和文件名。

-p TMFPath
指定包含跟踪信息格式 (.tmf) 文件的目录路径。

-o OutputFile
指定输出文件的名称。 该名称适用于格式化跟踪信息的文本文件和摘要文件。

OutputFile 是以 .txt 文件名为扩展名的路径和文件名，如 c:\traces\trace.txt。 默认值为本地目录中的 FmfFile.txt 和 FmtSum.txt。

如果将该参数与 -displayonly 或 -summaryonly 参数一起使用，只会影响摘要文件。

-csv
将跟踪日志格式化为逗号分隔、长度可变的 (.csv) 文件。

-显示
在命令提示符窗口中显示跟踪消息，并将其写入输出文件。

-displayonly
仅在命令提示符窗口中显示跟踪信息。 TraceView 不会创建跟踪信息文本文件。

-nosummary
不创建摘要消息文件。

-summaryonly
只创建摘要消息文件。 Tracefmt 不会创建输出文件。

-noprefix
省略跟踪消息前缀。 该参数会影响输出文件和 Tracefmt 显示屏中的跟踪消息。

-ods
将格式化的跟踪消息发送到调试器以显示。

-v
“详细”： 在 Tracefmt 处理每个跟踪消息块或缓冲区时，在命令提示符窗口中显示详细信息。 当怀疑文件损坏或不一致时，请使用此参数。

-h | /?
显示帮助。

示例

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

备注

要格式化跟踪消息，必须为跟踪消息指定一个跟踪消息格式文件。 可用方法按优先顺序排列：

• -tmf 参数。

• -p 参数。

• %TRACE_FORMAT_SEARCH_PATH% 环境变量。 将变量值设置为 TMF 文件所在的目录。

如果 TMF 文件名不是消息 GUID，请使用 -tmf 参数并输入文件的完全限定路径。 否则，TraceView 将无法找到 TMF 文件。

如果 TraceView 找不到 TMF 文件，或 TMF 文件不包含跟踪消息的格式化信息，则 TraceView 无法格式化信息。 取而代之的是，TraceView 写入的信息文本：“未找到格式信息”。

如果 TraceView 无法格式化跟踪消息，则会引发异常并显示如下消息：

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