Windows 事件跟踪

适用于 JD Edwards EnterpriseOne 的 Microsoft BizTalk 适配器将错误、警告和信息消息记录到 Windows 事件查看器中。 可以使用 Windows (ETW) 工具查看其他跟踪消息。 激活 ETW 后,会创建一个 *.etl 文件以接收这些消息。 该文件为二进制格式,必须将其转换为可读格式。 为此,必须有一个使用者应用程序可用于解释 *.etl 文件;例如,tracerpt.exe 或 tracedmp.ex。 tracept.exe 应用程序将 *.etl 转换为两个文本文件:summary.txt 和 dumpfile.csv。

ETW 组件

Windows 事件跟踪包括以下三个组件:

  • 控制器应用程序。 激活和停用提供程序(例如 tracelog.exe 或 logman.exe)。

    设置 PATH 环境变量以指向 tracelog.exe 的位置。 这可确保 BTAJDEEnterpriseOneTrace 调用可以在系统中查找 tracelog.exe。 默认情况下,BTAJDEEnterpriseOneTrace 搜索当前路径。

注意

tracelog.exe 可从 Microsoft SDK 获取,并与 BizTalk Adapter for JD Edwards EnterpriseOne 提供的命令兼容。 若要使用 logman.exe,请参阅 logman 文档。

  • 使用者应用程序。 读取记录的事件。 为了让使用者应用程序能够读取 etl 文件中的事件,Windows 事件跟踪必须将这些事件转储到该文件。 通常,该操作在控制器停用跟踪时完成。

    若要在不停用跟踪的情况下使用使用者应用程序,控制器必须使用实时选项 <> 实时 = -rt 激活跟踪。

  • 提供程序。 用于提供事件。 用于 JD Edwards EnterpriseOne 的 BizTalk 适配器包括三种不同的提供程序。 它们在 Windows Management Instrumentation (WMI) 中进行注册。 若要在根 \WMI\EventTrace 路径中找到已注册的提供程序,您可以使用诸如 WMI CIM Studio 之类的工具。

    适用于 JD Edwards EnterpriseOne 的 BizTalk 适配器包含三个提供程序,可用于记录不同类型的消息:

  • 接收方日志记录提供程序: <Trace 元素> 开关为 -receiver。 使用 -receiver 从日志中获取适配器在运行时收到的任何消息。

  • 发送器日志记录提供程序:跟踪 <元素> 开关为 -发送器。 使用 -发送器 从日志中获取适配器在运行时传输的任何消息。

  • 管理日志记录提供程序: <Trace 元素> 开关为 -management 使用 -management 从浏览服务器系统期间生成的日志中获取任何消息。

BTAJDEEnterpriseOneTrace 命令

若要使用 ETW,请运行 BizTalk Adapter for JD Edwards EnterpriseOne 命令 BTAJDEEnterpriseOneTrace.cmd。 如下所示使用此命令:

BTAJDEEnterpriseOneTrace <Trace element> -start [-cir <MB>|   
-seq <MB>] [-rt] logfile  
BTAJDEEnterpriseOneTrace <Trace element> -stop  
  

其中: <跟踪元素> (必需的) 是提供程序类型。

其选项包括:

  • -transmitter

  • -接收机

  • -管理

  • -start, -stop:激活或停用提供程序。

  • -cir <MB>:文件的大小和类型。 -cir 是循环文件。 <MB>:以 meg 为单位的大小。

  • -seq <MB>:文件的大小和类型。 -seq 是顺序文件。 <MB>:以 meg 为单位的大小。

  • -rt:将实时模式设置为打开。

  • Logfile: (c:\rtlog.etl 为默认) 日志文件的名称。

    例如:

BTAJDEEnterpriseOneTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl  
BTAJDEEnterpriseOneTrace -transmitter -stop  

另请参阅

JD Edwards EnterpriseOne 疑难解答