Trace 节点

本主题包含以下部分:

用途

使用 Trace 节点生成可以合并文本、消息内容及数据和时间信息的跟踪记录,帮助您监控消息流的行为。

您可将记录写到用户跟踪文件、另一个文件或本地错误日志(包含由所有其他 WebSphere Message Broker 组件记录的错误和信息消息)。如果将跟踪写到本地错误日志,则可以从 WebSphere Message Broker 随附提供的缺省消息编目发出消息,或创建自己的消息编目。

Trace 节点的操作独立于它驻留的消息流的用户跟踪设置。尤其是,即使用户跟踪当前对于消息流是不活动的,也要将 Trace 节点写到用户跟踪日志的记录。

Trace 节点在工作台中由以下图标表示:

“Trace 节点”图标

在消息流中使用此节点

查看以下样本,了解如何使用此节点:

包含 Trace 节点帮助您诊断消息流中的错误。通过跟踪流中各种点的消息的内容,您可以确定处理的顺序。您还可以配置 Trace 节点来记录消息内容及检查消息上特定节点的操作。例如,您可以在 Compute 节点后直接包含 Trace 节点来检查输出消息的格式是否为所需的。

如果已测试消息流并证明其操作正确,则从消息流除去 Trace 节点。

您还可以使用 Trace 节点提供消息流内错误处理的信息。例如,您可以使用该节点来记录处理中由于消息内容或格式中的错误而导致的故障。

配置 Trace 节点

当您将 Trace 节点的实例放入消息流时,就可以配置它。右键单击编辑器视图中的节点,然后选择属性。将显示该节点的基本属性。

对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。

如下所示配置 Trace 节点:

  1. 设置目的地属性表明编写来自 Trace 节点的输出的位置:
    • 要将跟踪记录写到本地系统错误日志,则选中本地错误日志

      您包含则 trace 记录中的信息写到:

      • 在 Windows 上,事件日志(应用程序视图)。
      • 在 UNIX 上 syslog
      • 在 z/OS 上操作员控制台。

      如果您选择此选项,则必须表明要写的跟踪消息数以及定义该消息的消息编目。

      • 如果您将消息编目留为空白,则与 WebSphere Message Broker 一起提供的缺省消息编目用作要写的消息源。

        您还必须在消息号中输入记录的错误号。号码 30513099 保留在 WebSphere Message Broker(缺省)编目以供使用。缺省消息编目中这些消息的各个文本是一致的,但对于您跟踪的每个情况,如果在该范围内使用不同的号码,则可标识导致错误的确切原因。缺省消息号是 3051

      • 如果创建自己的消息编目,则为消息编目中的编目输入全限定文件名。

        还必须为编目中要写到消息号内本地错误日志的消息输入相应的号码。在某些平台上,保留以 00 结束的消息号供系统使用;请勿在消息编目中包含号码类似 3100 的消息。

    • 如果要将跟踪记录写到系统生成的用户跟踪日志,则选中用户跟踪

      无论已部署消息流的用户跟踪属性的设置如何,都将这些记录写入用户跟踪日志。

      用户跟踪写到根目录的 \log 子目录(例如,Windows 2000 上的缺省目录为 c:\Program Files\IBM\WebSphere Message Broker)。文件名由代理名、代理 UUID 和 userTrace.bin 的后缀组成(例如,broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0)。 在查看用户跟踪日志前,使用 mqsireadlogmqsiformatlog 命令。

    • 如果您要将跟踪记录写到您选择的文件,则选择文件

      如果选择该选项,您还必须将文件路径设置为到跟踪的全限定路径名。如果未设置该路径,则文件的位置取决于系统。例如,在 z/OS 上,在代理服务标识的主目录内创建文件。

      您可以使用跟踪文件的任何名称。例如,c:\$user\trace\trace.log

      如果您指定尚未存在的文件,则创建该文件。然而,目录不是由此进程创建的,因 此全部路径必须已经存在。

    • 如果您不要写任何跟踪记录,则选择
  2. 模式中,创建 ESQL 模式指定写什么信息。如果您将跟踪记录写到本地错误日志,则模式管控在所选的消息号的文本中写的信息。如果使用缺省消息编目,而号码介于 30513099 之间,则模式信息按 &1 插入消息文本。
    • 您可编写纯文本,它完全按所输入的内容复制到跟踪记录。
    • 您可以标识消息的某些部分写到跟踪记录,并指定用字符 ${} 将完整字段标识括起。要记录整个消息,指定 ${Root}
    • 您可以使用 ESQL 函数来提供其他信息。例如,您可以使用 ESQL 函数 CURRENT_DATE 在写跟踪记录的位置记录日期和/或时间。

    下面的模式描述了一些可用的选项。它写文本的初始行,记录当前消息的两个元素并添加简单时间戳记:

    传递的消息附带以下字段:Store name is
    ${Body.storedetailselement.storename}
    Total sales are ${Body.totalselement.totalsales}
    Time is: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)}
    		:${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)}

    结果跟踪记录为:

    传递的消息附带以下字段:Store name is 'SRUCorporation'
    Total sales are '34.98'
    Time is: 11:19

    包含语法错误的模式不阻止部署包含 Trace 节点的消息流,但该节点不编写任何跟踪记录。

  3. 选择属性对话框导航器中的“描述”,以输入简短描述和/或详细描述。
  4. 单击应用在不关闭“属性”对话框的情况下对 Trace 节点进行更改。单击确定以应用更改,并关闭属性对话框。

    单击取消以关闭对话框,并废弃对属性所作的所有更改。

终端和属性

下表描述 Trace 节点的终端。

终端 描述
In 接受供节点处理的消息的输入终端。
Out 传播消息的输出终端。

下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。

下表描述 Trace 节点的“基本”属性。

属性 M C 缺省值 描述
目的地 用户跟踪 节点所写的跟踪记录的目的地。有效选项为用户跟踪文件本地错误日志
文件路径   记录所写到的文件的全限定文件名。仅当目的地设置为文件是才有效。
模式   要包含在跟踪记录中的数据。
消息编目   抽取异常的错误号的错误文本的消息编目的名称。缺省值(空白)表明从与 WebSphere Message Broker 一起提供的消息编目采用消息。
消息号 3051 所写的消息错误号。

下表描述 Trace 节点的“描述”属性。

属性 M C 缺省值 描述
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac04840_