使用 Windows 事件跟踪
Microsoft BizTalk Adapter for TIBCO Rendezvous 将错误、警告和信息消息记录到 Windows 事件查看器。 可以使用 Windows 事件跟踪工具(ETW)查看其他跟踪消息。 激活 ETW 后,它会创建一个 *.etl 文件来接收消息。 此文件采用二进制格式,必须转换为读取。 为此,你必须有一个使用者应用程序可用于解释 *.etl 文件,例如,tracerpt.exe 或 tracedmp.exe。 例如,tracerpt.exe 应用程序将 *.etl 文件转换为两个文本文件:summary.txt 和 dumpfile.csv。
ETW 组件
Windows 事件跟踪有三个组件:
控制器应用程序:激活和停用提供程序(例如,tracelog.exe 或 logman.exe)。
将 PATH 环境变量设置为指向 tracelog.exe的位置。 这可确保 BTATIBCO RendezvousTrace 的调用可以在系统中定位 tracelog.exe。 默认情况下,BTATIBCO RendezvousTrace 搜索当前路径。
注释
tracelog.exe 可从 Microsoft SDK 获取,并与 Microsoft BizTalk Adapter for TIBCO Rendezvous 提供的命令兼容。 若要使用 logman.exe,请参阅 logman 文档。
使用者应用程序:读取记录的事件。
要使使用者应用程序能够读取 etl 文件中的事件,Windows 事件跟踪必须将事件转储到该文件中。 通常,当控制器停用跟踪时,会执行此作。
若要在不停用跟踪的情况下使用使用者应用程序,控制器必须使用实时选项( <实时> = -rt)激活跟踪。
提供程序:提供事件。
适用于 TIBCO Rendezvous 的 BizTalk 适配器包括三个不同的提供程序。 它们已注册在 Windows Management Instrumentation(WMI)中。 若要在 root\WMI\EventTrace 路径中找到已注册的提供程序,可以使用 WMI CIM Studio 等工具。
用于 TIBCO Rendezvous 的 BizTalk 适配器有三个供应商。 这样就可以记录不同类型的消息:
接收方日志记录提供程序: <跟踪元素> 开关为 -receiver。
使用 -receiver 从适配器在运行时收到的日志中获取任何消息。
发送器日志记录提供程序: <跟踪元素> 开关为 -发送器。
使用 -发送器 从运行时适配器传输的日志中获取任何消息。
管理日志记录提供程序 -< 跟踪元素>选项为 -management。
使用 -management从浏览服务器系统期间生成的日志中获取任何消息。
BTATIBCORVTrace 命令
若要使用 ETW,请运行用于 TIBCO Rendezvous 命令的 BizTalk 适配器,BTATIBCORVTrace.cmd。 使用此命令,如下所示:
BTATIBCORVTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTATIBCORVTrace <Trace element> -stop
其中:<跟踪元素>(必填)是供应商的类型。
其选项如下所示:
-发射机
-接收器
-管理
-start、-stop:激活或停用提供程序。
-cir <MB>:文件大小和文件类型。 -cir 是一个循环文件。 <MB>:大小(以兆字节为单位)。
-seq <MB>:文件大小和文件类型。 -seq 是一个顺序文件。 <MB>:大小(以兆字节为单位)。
-rt:设置实时模式。
Logfile:日志文件的名称(c:\rtlog.etl 为默认值)。
例如:
BTATIBCORVTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTATIBCORVTrace -transmitter -stop