使用 Windows 事件跟踪

适用于 PeopleSoft Enterprise 的 Microsoft BizTalk 适配器将错误、警告和信息消息记录到 Windows 事件查看器。 使用 Windows 事件跟踪 (ETW) 工具,可以看到更多的跟踪消息。 如果启用 ETW,将创建一个 *.etl 文件以接收消息。 该文件为二进制格式,必须经过转换才能进行读取。 为此,您必须具有用于解释 *.etl 文件的使用者应用程序,例如 tracerpt.exe 或 tracedmp.exe。

ETW 组件

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

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

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

    注意

    tracelog.exe 可从 Microsoft SDK 获得,它与用于 PeopleSoft Enterprise 的 BizTalk 适配器提供的命令兼容。 若要使用 logman.exe,请参阅 logman 文档。

  • 使用者应用程序:读取记录的事件。

    为了让使用者应用程序能够读取 .etl 文件中的事件,Windows 事件跟踪必须将其转储到该文件中。 通常,当控制器停用跟踪时执行此操作。

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

  • 供应商: 提供 事件。

    用于 PeopleSoft Enterprise 的 BizTalk 适配器具有五个不同的提供程序。 它们在 Windows Management Instrumentation (WMI) 中进行注册。 若要在 root\WMI\EventTrace 路径中查找已注册的提供程序,可以使用 WMI CIM Studio 等工具。

    用于 PeopleSoft Enterprise 的 BizTalk 适配器具有五个提供程序,从而允许您记录不同种类的消息:

  • 接收方日志记录提供程序: <跟踪元素> 开关为 -receiver

  • 接收方 CastDetails 提供程序:Trace <元素> 开关为 -castDetailsReceive

  • 发送器日志记录提供程序:跟踪 <元素> 开关为 -transmitter

  • 发射机 CastDetails 提供程序: <Trace 元素> 开关为 -castDetailsTransmit

  • 管理日志记录提供程序:Trace <元素> 开关为 -management

BTAPeopleSoftTrace 命令

若要使用 ETW,请运行适配器命令 BTAPeopleSoftTrace.cmd。 如下所示使用此命令:

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

其中:

  • <跟踪元素> (必需的) 提供程序类型。

    选项如下:

    • -castDetailsTransmit

    • -transmitter

    • -castDetailsReceive

    • -接收机

    • -管理

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

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

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

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

  • 日志文件: (C:\rtlog.etl 的日志文件的名称是默认) 。

    例如:

BTAPeopleSoftTrace -transmitter -start -cir 10 -rt C:\log\mylog.etl  
BTAPeopleSoftTrace -transmitter -stop  

另请参阅

PeopleSoft 疑难解答