本主题包含以下部分:
使用 Trace 节点生成可以合并文本、消息内容及数据和时间信息的跟踪记录,帮助您监控消息流的行为。
您可将记录写到用户跟踪文件、另一个文件或本地错误日志(包含由所有其他 WebSphere Message Broker 组件记录的错误和信息消息)。如果将跟踪写到本地错误日志,则可以从 WebSphere Message Broker 随附提供的缺省消息编目发出消息,或创建自己的消息编目。
Trace 节点的操作独立于它驻留的消息流的用户跟踪设置。尤其是,即使用户跟踪当前对于消息流是不活动的,也要将 Trace 节点写到用户跟踪日志的记录。
Trace 节点在工作台中由以下图标表示:
当您将 Trace 节点的实例放入消息流时,就可以配置它。右键单击编辑器视图中的节点,然后选择属性。将显示该节点的基本属性。
对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。
如下所示配置 Trace 节点:
您包含则 trace 记录中的信息写到:
如果您选择此选项,则必须表明要写的跟踪消息数以及定义该消息的消息编目。
您还必须在消息号中输入记录的错误号。号码 3051 到 3099 保留在 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)。 在查看用户跟踪日志前,使用 mqsireadlog 和 mqsiformatlog 命令。
如果选择该选项,您还必须将文件路径设置为到跟踪的全限定路径名。如果未设置该路径,则文件的位置取决于系统。例如,在 z/OS 上,在代理服务标识的主目录内创建文件。
您可以使用跟踪文件的任何名称。例如,c:\$user\trace\trace.log。
如果您指定尚未存在的文件,则创建该文件。然而,目录不是由此进程创建的,因 此全部路径必须已经存在。
下面的模式描述了一些可用的选项。它写文本的初始行,记录当前消息的两个元素并添加简单时间戳记:
传递的消息附带以下字段: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 节点的消息流,但该节点不编写任何跟踪记录。
单击取消以关闭对话框,并废弃对属性所作的所有更改。
下表描述 Trace 节点的终端。
终端 | 描述 |
---|---|
In | 接受供节点处理的消息的输入终端。 |
Out | 传播消息的输出终端。 |
下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。
下表描述 Trace 节点的“基本”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
目的地 | 是 | 否 | 用户跟踪 | 节点所写的跟踪记录的目的地。有效选项为用户跟踪、文件、本地错误日志和无。 |
文件路径 | 否 | 是 | 记录所写到的文件的全限定文件名。仅当目的地设置为文件是才有效。 | |
模式 | 否 | 否 | 要包含在跟踪记录中的数据。 | |
消息编目 | 否 | 否 | 抽取异常的错误号的错误文本的消息编目的名称。缺省值(空白)表明从与 WebSphere Message Broker 一起提供的消息编目采用消息。 | |
消息号 | 否 | 否 | 3051 | 所写的消息错误号。 |
下表描述 Trace 节点的“描述”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |