使用日志和跟踪文件进行故障诊断

本节描述如何使用日志和跟踪文件进行故障诊断。包括以下主题:

日志和跟踪文件的概述

配置日志消息的电子邮件通知

配置记录和跟踪

在日志查看器中处理跟踪

日志和跟踪文件的概述

记录用来传递系统消息、组件状态更改、故障和跟踪信息。从 InterChange Server Express、协作对象和连接器生成的消息被发送至您安装 InterChange Server Express 时指定的目标,缺省情况下为 STDOUT(标准输出)。从连接器代理程序生成的消息被发送至 STDOUT,但可以配置为发送至位于代理程序位置的单独日志文件中。

注:
OS/400 和 i5/OS 上的 STDOUT 导致将信息写入与 InterChange Server Express 作业相关联的假脱机文件。因此,在 OS/400 和 i5/OS 上,记录在缺省情况下配置为发送至 /QIBM/UserData/WBIServer44/serverName/log 目录中的文件,其中 serverName 是 InterChange Server Express 实例的名称(缺省服务器名称是 QWBIDFT44)。

消息传递系统始终处于活动状态并准确监视系统。

注:
如果将从连接器代理程序生成的消息配置为发送至单独的日志文件,则必须指定与 InterChange Server Express 日志文件分开的日志文件或位置。

除标准输出之外,还可以将消息传递系统配置为将消息发送至日志文件或电子邮件收件人。可以为日志文件配置备份文件(归档文件),并可以确定它们的大小。当出现问题且需要详细信息进行故障诊断时,可以配置跟踪(由于它影响系统资源,因此缺省情况下禁用跟踪)。

有两个工具提供了用于配置和查看消息记录和跟踪的图形用户界面:

注:
日志查看器仅在 Windows 2000 或 Windows XP 操作系统上运行。要使用日志查看器来配置或查看 Linux 或 OS/400 和 i5/OS 日志文件或消息,将该文件复制到已安装 IBM WebSphere InterChange Sever Express 产品的 Windows 机器上,或将网络驱动器从 PC 映射至 OS/400 和 i5/OS 系统并直接从映射的驱动器访问日志文件。
注:
在 OS/400 和 i5/OS 上,根据两个系统值 QTIME 和 QUTCOFFSET 的设置以及 /QIBM/UserData/Java400/ 目录 SystemDefault.properties 文件中的 user.timezone 属性的设置,来确定日志和跟踪文件中的时间戳记。当 user.timezone 设置为某个值时,例如 user.timezone=EDT,则 OS/400 和 i5/OS 上的 Java 以东欧夏令时生成时间戳记。如果未设置 user.timezone,则 OS/400 和 i5/OS 上的 Java 通过采用 QTIME 并从它减去 QUTCOFFSET 的值以格林威治标准时间(GMT)生成时间戳记。因此,例如,如果 QUTCOFFSET 是 -04:00(它是东欧时区),则 Java 将从 QTIME 的当前值减去 -4 来获得 GMT。在 OS/400 和 i5/OS V5R3 上,您将设置系统值 QTIMZON,而不是设置 QUTCOFFSET。请参阅帮助文本以获取有关 OS/400 和 i5/OS 上系统值的更多信息。

除了使用日志查看器来查看日志之外,还可以使用文本编辑器来打开日志或创建自己的工具来过滤日志文件。

有关使用日志查看器来查看记录和跟踪消息的信息,请参阅日志查看器和跟踪的概述

本节包括以下主题:

协作对象消息

连接器消息

消息格式

系统日志

日志/跟踪文件管理

协作对象消息

协作对象可以生成消息来报告运行时信息、警告和错误。例如,协作可以记录其决策点和操作的结果。

当 InterChange Server Express 执行协作对象时,它将其消息写至其日志。有关配置系统记录的信息,请参阅配置记录和跟踪

另外,还可以通过电子邮件将协作对象的消息发送至一个或多个收件人。可以为每个协作对象单独指定一组电子邮件收件人。有关使用电子邮件通知的规则的信息,参阅配置日志消息的电子邮件通知

连接器消息

连接器消息被发送至 InterChange Server Express 消息目标。视操作系统而定,消息以下列方式的其中一种方式出现:

有关连接器记录的信息,请参阅连接器代理程序日志

为了帮助进行故障诊断,在连接器代理程序引导期间创建了一个临时日志文件,它包含从连接器控制器获取的元数据。该元数据由业务对象规范、属性和支持变化量的属性组成。该文件命名为 connectornametmp.log,它在 ProductDir\Connectors 目录中。

消息格式

所有消息都经过格式化,所以很容易过滤。InterChange Server Express 和连接器的已记录消息使用相同格式,该格式在表 17 中进行了描述。当配置业务对象以获取流跟踪消息时,它们使用这些字段和其它字段(在表 17 中由星号表示)。传递至 InterChange Server Express 的消息具有以下格式,使用以下某些或全部参数:

Time: System Name: Thread: MsgType MsgID: SubSystem: FIID: BO: MsgText: BOD:

表 17. 消息格式
变量 描述
Time 时间戳记:以时间格式 year/month/date 表示的记录日期
System 组件的类型(系统标识)。它可以是服务器、协作、业务对象或连接器代理程序。
Thread 线程名称和线程标识
Name 组件的名称,如 ClarifyConnector。
MsgType 消息的严重性。请参阅表 18
MsgID 消息号。
SubSystem* 当前系统的子系统。它可以是事件管理、消息传递、存储库或数据库连接。
FIID* 业务对象的流启动程序标识。
BO* 业务对象名。
MsgText 消息号的相关文本。
BOD* 业务对象转储。业务对象中包含的数据。

以下是服务器消息的示例:[Time: 2001/06/07 11:01:29.487] [System: Server] [SS: REPOSITORY] [Thread: VBJ ThreadPool Worker (#-1767149274)] [Type: Trace ] [Mesg: Released session REPOSITORY0]

表 18 描述 InterChange Server Express 消息的类型。

表 18. 消息类型
类型 描述
信息 仅供参考。不需要执行操作。
警告 InterChange Server Express 选择的缺省条件。
错误 您应调查的严重问题。
致命错误 停止操作且应报告的错误。
跟踪 所指定跟踪级别的跟踪信息。
流跟踪 业务对象的流跟踪信息。
内部错误 应调查的严重内部问题。
内部致命错误 停止操作的内部错误。应报告它。

注:
如果出现具有“内部错误”或“内部致命错误”严重性的消息,则记录问题所处的环境,然后与 InterChange Server Express 技术支持机构联系。

系统日志

InterChange Server Express 日志

InterChange Server Express 可以将消息记录至以下目标:

除管理定期记录之外,InterChange Server Express 还可以在生成错误或致命错误消息时将电子邮件消息发送至指定的用户。

缺省情况下,跟踪消息被发送至系统日志文件。在某些情况下,此文件可能变得太大,因此建议您指定单独的跟踪文件。有关为跟踪消息设置单独文件的指示信息,请参阅跟踪文件

配置记录和跟踪描述如何设置记录目标。

要指定电子邮件通知的收件人,请参阅配置日志消息的电子邮件通知

日志/跟踪文件管理描述如何避免使日志文件变得太大。

连接器代理程序日志

连接器代理程序和连接器控制器具有各自的记录机制。本节描述连接器代理程序记录。连接器控制器消息被发送至包含 InterChange Server Express 消息的日志。

连接器代理程序将消息记录至本地目标并且还可以将其消息发送至 InterChange Server Express 进行记录。要指定日志文件名,编辑连接器的 LogFileName 属性(使用连接器配置器捷版)并插入要使用的日志文件的名称。

如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。

缺省日志文件(位于 STDOUT 中)包含来自连接器的错误和参考消息的文本。Name 是应用程序的名称。

表 19 描述可以编辑的属性,它们确定连接器代理程序将消息记录至何处。

表 19. 连接器代理程序日志消息属性
属性名 描述 值的类型
LogAtInterchangeEnd 指定连接器代理程序除将消息记录至本地之外是否还将消息发送至 InterChange Server Express。

在 InterChange Server Express 中,根据 InterchangeSystem.cfg 文件,在服务器消息出现的地方都会出现连接器代理程序消息。

true(将消息发送至 InterChange Server Express 并启用电子邮件)或 false(仅将消息记录至本地)。缺省值是 false
LogFileName 指定在本地系统上的何处写入连接器代理程序消息。 文件路径或标准输出(STDOUT)。缺省值为 STDOUT

有关配置这些属性的指示信息,请参阅配置连接器代理程序记录目标的步骤

日志/跟踪文件管理

InterChange 系统启动时,如果日志文件不存在,将创建一个;如果日志文件存在,则向其追加记录。如果日志文件的大小不受限制,则它会增长,并且其大小取决于自上次管理它以来的时间量以及经过系统的事务量。如果日志文件增长太大,您可能无法打开它或应用程序可能需要更多的系统资源才能写入文件。

InterChange Server Express 系统日志文件可以配置为指定的大小,在它们达到该大小后,就会自动将它们归档。作为一项额外的预防措施,可以指定许多归档文件来用作系统备份。每当日志文件达到其最大大小时,该文件将重命名为新的归档文件。归档文件的名称自原始日志或跟踪文件名派生,并在名称中插入以下各项:

_Arc_ number

例如,使用 5 个归档文件时,如果日志文件具有名称 InterchangeSystem.log,则创建的第一个归档文件命名为 InterchangeSystem_Arc_01.log。当新的日志文件填满时,InterchangeSystem_Arc_01.log 重命名为 InterchangeSystem_Arc_02.log,日志文件再次保存至 InterchangeSystem_Arc_01.log,直到存在 5 个归档文件为止。如果存在 5 个归档文件,则创建新的日志文件时,将重命名现有的归档文件并将其编号加 1,以便归档数目与您配置的数目匹配,然后删除最旧的文件(其归档号为 05)。图 51 显示使用此配置的文件的进行情况。

图 51. 循环归档记录

有关详细信息,请参阅配置任务配置记录和跟踪

如果系统日志文件配置为无限制的大小,则 InterChange Server Express 写入日志,直到日志文件所在的磁盘逐渐地填满;如果不管理磁盘,则当磁盘变满时系统会返回一条错误消息。

应定期删除以下文件中的数据:

除以上日志文件之外,还存在特定于每个应用程序的其它日志文件。大多数文件将在运行时期间创建(如果它们尚未存在的话)。将把新信息追加至任何现有文件。在继续备份之前,必须停止给文件提供日志信息的每个组件。

可以使用任何文件管理过程,但建议使用以下定期日志文件管理:

跟踪文件

要对问题进行故障诊断,可以打开跟踪。跟踪消息帮助您监视在 InterChange Server Express 系统的组件中执行的操作。跟踪级别定义写入跟踪文件的详细信息的数量。跟踪级别越高,您接收的信息越详细。跟踪与记录有以下不同:

缺省情况下,由于跟踪生成比您通常所需的更详细的消息,所以跟踪是关闭的。当 InterChange Server Express 在运行时,可以按需要打开和关闭跟踪。

InterChange Server Express 的跟踪服务

InterChange Server Express 的跟踪服务最初在 InterChange Server Express 的配置文件(缺省情况下,此文件名为 InterchangeSystem.cfg 并位于产品的顶级目录中)的参数中设置。有关这些参数的详细信息,请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 和 i5/OS 版》。可以在系统管理器的“编辑配置”工具中更新这些参数的设置,如配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤中所述。

协作对象跟踪

可以跟踪协作对象的执行情况。跟踪将有关协作对象的执行情况的详细消息写至在 InterchangeSystem.cfg 文件中指定的日志目标。跟踪协作是持久的。协作有两个跟踪级别设置:系统级别和协作级别。

系统级别跟踪返回协作的运行时信息。例如,如果要跟踪协作的状态更改,则将系统跟踪级别设置为 3。

可以将协作对象跟踪设置为以下其中一个级别:

表 20. 协作对象跟踪级别
跟踪级别 描述
1 跟踪从连接器接收业务对象的情况和适当方案的启动。
2 打印级别 1 的消息。另外,还跟踪每个方案的启动和完成,并报告向前执行和回滚。
3 打印级别 1 和 2 的消息。另外,还跟踪每个方案决策块或操作的执行。
4 打印级别 1 至 3 的消息。另外,还跟踪每个方案发送和接收每个业务对象的情况。
5 打印级别 1 至 4 的消息。另外,还跟踪每个方案发送和接收每个业务对象的情况,并打印业务对象中每个属性的值。

有关配置指示信息,请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤

连接器跟踪

连接器包含两个组件:连接器控制器和连接器代理程序。这两个组件可以在网络上的不同位置且可以用不同方式跟踪。

可以将连接器代理程序和控制器跟踪设置为以下级别之一:

表 21. 连接器代理程序和控制器跟踪级别
跟踪级别 描述
1 跟踪初始化和业务对象的发送和接收。
2 打印级别 1 的消息,另外,还为相同类型的事件提供比级别 1 更多的详细信息。
3 打印级别 1 和 2 的消息。另外,还跟踪连接器代理程序和消息传递驱动程序之间的消息交换。
4 打印级别 1 至 3 的消息。另外,还跟踪连接器的内部级别之间的业务对象的传递。
5 打印级别 1 至 4 的消息。另外,还跟踪连接器的内部级别之间的管理消息的传递。

新的或更改的跟踪级别立即生效。

如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。

有关配置指示信息,请参阅配置连接器跟踪的步骤

映射跟踪

您可以使用系统管理器来设置映射跟踪。跟踪映射对于调试和跟踪信息以及由映射创建的错误消息很有用。缺省情况下,映射跟踪处于关闭状态。

有关跟踪映射的更多信息,请参阅 Map Development Guide。有关配置指示信息,请参阅配置映射跟踪的步骤

业务对象跟踪(流跟踪)

业务对象跟踪记录提供了一种跟踪业务对象的进行情况的方式,该方式基于在每个处理点生成的通知消息,从一个处理点到另一个处理点进行跟踪。例如,对于级别 2 跟踪,当业务对象到达协作以进行处理时,将记录一条跟踪消息。

表 22 描述与业务对象跟踪相关联的可配置的级别:

表 22. 业务对象跟踪级别
跟踪级别 描述
0 不跟踪。
1 事件状态(如成功或失败)和事件标识信息。
2 最小事件跟踪。关于业务对象何时进入/退出系统(如连接器、映射、关系和协作)的信息。包括级别 1 信息。
3 提供来自级别 2 的事件跟踪和进入/退出系统时的业务对象转储。系统性能受影响。
4 详细的跟踪。提供对系统组件(如连接器、映射、关系和协作)的跟踪并将这些跟踪映射至级别 3 事件跟踪。此级别的跟踪会影响系统性能。

有关配置指示信息,请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤

Web 网关跟踪

提供两个级别的 Web 网关跟踪:最小和最大。此跟踪允许您查看关于是否在网关上正确地执行通信处理的信息。通过网关配置工具设置网关跟踪级别。有关指示信息,请参阅 System Implementation Guide

表 23 描述与网关跟踪相关联的可配置的级别:

表 23. 网关跟踪级别
跟踪级别 描述
0 不跟踪。
1 最小跟踪(如绑定请求、套接字打开等等)。
5 最大跟踪(如 HTTP/HTTPS 请求,包括所有报头。)

配置日志消息的电子邮件通知

记录至 InterChange Server Express 日志的错误和致命消息还可以通过电子邮件发送给 InterChange Server Express 系统管理员或任何其它收件人。缺省情况下,InterChange Server Express 配置为使用“Java 邮件”发送电子邮件通知,但您可以将服务器配置为使用电子邮件连接器发送电子邮件通知。有关使用电子邮件连接器配置电子邮件通知的指示信息,参阅在系统级别配置电子邮件通知的步骤

注:
如果要为电子邮件通知配置协作,必须使用电子邮件连接器。

可以配置以下组件来将错误和致命消息发送至电子邮件收件人:

可以在系统级别(在 InterchangeSystem.cfg 文件中设置)、协作对象级别(设置为协作对象属性)或连接器级别(设置为连接器属性)配置电子邮件通知。如果在系统级别配置电子邮件通知,则该配置应用于系统中的所有协作对象或连接器。如果在协作对象或连接器级别配置电子邮件通知,则该配置仅应用于该特定组件并取代系统配置。

InterChange Server Express 系统中的电子邮件通知支持“简单邮件传输协议”(SMTP)邮件消息,因此,InterchangeSystem.cfg 文件中的电子邮件收件人值和协作电子邮件地址必须是标准因特网地址。

有效的电子邮件地址条目可以是由逗号隔开的一个或多个标准因特网地址。例如,两个收件人的有效条目是:

JohnDoe@company.com,FredSmith@company.com

不能使用个人地址别名,如在个人地址簿中定义的别名。然而,有效地址可以是邮件服务器中定义的别名,如 Eng@company.com。在这种情况下,邮件服务器将别名进行译码并将电子邮件发送至该别名的所有成员。例如,译码后的别名可能是 person1@some_company.com、person2@another_company.com,等等。

在系统级别配置电子邮件通知的步骤

执行下列步骤来在系统级别配置电子邮件通知:

  1. 打开系统管理器
  2. 在“InterChange Server 组件管理”视图中,右键单击服务器并单击编辑配置

    编辑工具打开,您可以在该工具中编辑 InterchangeSystem.cfg 文件。

  3. 单击电子邮件选项卡。

    出现一个对话框,该对话框允许输入在系统级别配置电子邮件通知所必需的参数(请参阅图 52)。

    图 52. 编辑配置,“电子邮件”选项卡
  4. 电子邮件发送类型列表中选择一个电子邮件类型:
  5. 在每个子系统字段中输入一个或多个有效的电子邮件地址。该地址必须符合 SMTP 标准。
  6. 在系统管理器中,单击文件 > 保存 ServerName。您输入的系统级别电子邮件通知信息保存在 InterchangeSystem.cfg 文件中。
  7. 在已配置连接器邮件的情况下的附加步骤:配置 EmailNotification 业务对象,以便在指定的电子邮件收件人无法收到电子邮件时保留他的电子邮件地址。作为一种失败时的安全措施,可能是邮件管理员而不是 InterChange Server Express 系统管理员,来确保在不可到达 InterChange Server Express 管理员时邮件被传递。

    执行以下操作:

  8. 在已配置连接器邮件的情况下的附加步骤:配置电子邮件连接器。

    执行以下操作:

在协作对象级别配置电子邮件通知的步骤

执行下列步骤来设置接收协作消息的电子邮件地址:

  1. 在系统管理器中,转至“InterChange Server 组件管理”视图,右键单击您要为其配置电子邮件通知的协作对象,然后单击属性

    出现“属性”对话框。

  2. 协作一般属性选项卡中,在电子邮件通知地址字段中输入有效的电子邮件地址。该地址必须符合 SMTP 标准。
  3. 单击确定以保存您的更改并关闭窗口。
  4. 重新启动协作以便更改生效。

在连接器级别配置电子邮件通知的步骤

您可以为特定连接器配置电子邮件通知,然而,在协作对象级别设置的配置参数将取代在系统级别设置的配置参数。

执行下列步骤来为特定连接器配置电子邮件通知:

  1. 在系统管理器中,右键单击要为其配置电子邮件通知的连接器,然后单击编辑定义

    出现“连接器配置器易捷版”窗口。

  2. 标准属性选项卡中,在 LogAtInterchangeEnd 属性的字段中选择 true。此值允许将连接器消息发送至 InterChange Server Express 日志。
  3. 单击文件 > 保存 > 至项目
  4. 关闭“连接器配置器易捷版”窗口。
  5. 重新启动连接器以便更改生效。

配置记录和跟踪

本节描述如何设置消息记录和跟踪。可以通过使用系统管理器中的“编辑配置”选项和通过手工编辑 InterchangeSystem.cfg 文件来进行这些设置。将描述以下任务:

打开“编辑配置”工具的步骤

配置 InterChange Server Express 记录和跟踪目标的步骤

配置其它 InterChange Server Express 记录和跟踪参数的步骤

配置连接器代理程序记录目标的步骤

配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤

配置协作对象跟踪级别的步骤

配置连接器跟踪的步骤

配置映射跟踪的步骤

打开“编辑配置”工具的步骤

要使用“编辑配置”工具,InterChange Server Express 必须正在运行并处于“已连接”状态。“编辑配置”工具在每个会话中只能管理一个 InterChange Server Express。

执行下列步骤来打开“编辑配置”工具:

  1. 打开系统管理器。
  2. 在“InterChange Server 组件管理”视图中右键单击某个服务器实例并单击编辑配置。“编辑配置”工具打开,您可以在该工具中编辑 InterchangeServer.cfg 文件。

配置 InterChange Server Express 记录和跟踪目标的步骤

当配置这些设置时,请牢记有关 STDOUT 的以下信息:

Linux

如果将记录和跟踪设置为至 STDOUT,则消息被自动重新路由至 $PRODUCTDIR/logs/ics_manager.log

i5/OS

如果您将记录和跟踪设置为至 STDOUT,则消息将写入与服务器作业相关联的假脱机文件中。

Windows

如果计划以服务的形式运行 InterChange Server,您必须将记录和跟踪设置为至文件目标。将记录和跟踪设置为至 STDOUT 会防止将 InterChange Server 配置为 Windows 服务。

执行下列步骤来配置 InterChange Server Express 消息记录和跟踪的目标:

  1. 在“编辑配置”工具中,单击跟踪/日志文件选项卡。

    出现记录和跟踪配置窗口(请参阅图 53)。

    图 53. “编辑配置”工具,“跟踪/日志文件”选项卡
  2. 记录下,选择系统记录的目标。可以记录至系统控制台和日志文件,但此选项仅应该用于调试且仅应该在开发系统上使用。执行以下操作:
  3. 跟踪下,选择系统跟踪的目标。执行以下操作:
  4. 要配置 IBM WebSphere MQ 跟踪,接受文件的缺省路径名或单击浏览按钮以浏览至日志文件。
  5. 选择文件 > 保存或按 Ctrl+S 键,以保存更改并退出。

您的更改立即生效,如果您已配置了日志文件,则将保存它并注明日期,并使用新输入的配置创建一个新文件。

配置堆栈跟踪的步骤

当启用了 InterChange Server Express 堆栈跟踪时,堆栈跟踪信息将打印至 InterChange Server Express 日志文件。此信息可用于对新安装的系统进行故障诊断。

执行下列步骤来配置堆栈跟踪功能:

  1. 打开“编辑配置”工具(请参阅打开“编辑配置”工具的步骤)。
  2. 单击跟踪/日志文件选项卡。
  3. 选择启用堆栈跟踪复选框。当启用堆栈跟踪时,跟踪严重性级别列表是可用的。
  4. 跟踪严重性级别列表中,选择要打印堆栈跟踪的严重性级别。选项有:INFOWARNINGERRORFATAL。当将堆栈跟踪打印至日志文件时,它将打印您选择的级别和该级别以上的所有级别。例如,如果您选择 ERROR,则 ERRORFATAL 消息都将打印至日志文件。

配置其它 InterChange Server Express 记录和跟踪参数的步骤

执行下列步骤来为日志文件和跟踪文件设置文件大小和归档文件数:

  1. 打开“编辑配置”工具(请参阅打开“编辑配置”工具的步骤)。
  2. 单击跟踪/日志文件选项卡。
  3. 要限制日志文件的大小,选择至文件无限制复选框,并从日志文件列表中选择一个数字来表示最大日志文件大小,然后选择字节KB (千字节)、MB(兆字节)、或 GB(千兆字节)。
  4. 要限制跟踪文件的大小,选择至文件无限制复选框,从跟踪文件列表中选择一个数字来表示最大跟踪文件大小,然后选择字节KB (千字节)、MB(兆字节)、或 GB(千兆字节)。
  5. 要设置日志或跟踪文件归档的数目,从记录跟踪部分下的归档数目列表中选择一个数字。
  6. 停止 InterChange Server Express 并重新启动它。

配置连接器代理程序记录目标的步骤

两个连接器组件都具有各自的记录机制。连接器控制器记录被发送至 InterchangeServer.log 文件。本节描述如何配置连接器代理程序日志文件名和位置。

有关连接器代理程序记录的背景信息,请参阅连接器代理程序日志

可以使用以下其中一种方法来设置连接器代理程序记录的目标:

执行下列步骤以使用连接器配置器易捷版来配置连接器代理程序记录的目标:

  1. 连接至服务器。
  2. 在系统管理器中,右键单击连接器对象,然后选择编辑定义。出现“连接器配置器易捷版”窗口。
  3. 单击标准属性选项卡。
  4. 选择一个记录属性值(有关这些值的说明,请参阅表 19),然后单击编辑
  5. 字段中输入新值,然后单击确定

    例如,将 LogAtInterchangeEnd 值更改为 true 以将消息发送至 InterChange Server Express 日志。如果将 InterChange Server Express 配置为当记录错误和致命消息时发送电子邮件,则也为连接器代理程序消息发送电子邮件。

  6. 如果需要,重复步骤 3 和 4 以编辑其它记录属性值。

    例如,要将连接器代理程序消息发送至消息文件而不是缺省值 STDOUT,则在字段中输入文件的完整路径名。

  7. 重新启动连接器以便更改生效。
注:
如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。

配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤

执行下列步骤来配置跟踪:

  1. 打开“编辑配置”工具(请参阅打开“编辑配置”工具的步骤)。
  2. 单击跟踪级别选项卡(请参阅图 54)。
    图 54. “编辑配置”工具,“跟踪级别”选项卡
  3. 要配置系统跟踪,在 IBM WebSphere Business Integration 跟踪级别下,为您要配置的子系统选择跟踪级别

    设置这些跟踪级别会更新 InterchangeSystem.cfg 文件中的参数。有关在各个跟踪级别生成哪些信息的指示信息,请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》和《WebSphere Business Integration Server Express 安装指南 OS/400 和 i5/OS 版》。

  4. 要配置协作跟踪,执行以下操作:
  5. 要配置业务对象跟踪,执行以下操作:
  6. 选择文件 > 保存或按 Ctrl+S 键,以保存更改并退出。

    子系统、业务对象和协作的跟踪级别立即生效。

配置协作对象跟踪级别的步骤

本节描述可以用来配置协作对象跟踪级别的两种方法之一。有关备用方法的信息,请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤

执行下列步骤来配置协作对象跟踪级别:

  1. 在系统管理器中,转至“InterChange Server 组件管理”视图,右键单击协作对象并单击属性。出现“属性”对话框。
  2. 在“协作一般属性”选项卡上执行下列其中一项操作:

配置连接器跟踪的步骤

执行下列步骤来配置连接器跟踪:

  1. 从系统管理器中,右键单击连接器对象,然后单击编辑定义。出现“连接器配置器易捷版”窗口。
  2. 执行下列其中一项操作:
  3. 单击文件 > 保存 > 至项目
  4. 关闭连接器配置器易捷版。

    对这些属性的更改立即生效。无论 InterChange Server Express 将其跟踪消息发送至何处,都会出现连接器控制器的跟踪消息;无论连接器代理程序在何处记录消息,都会出现连接器代理程序的跟踪消息。

    注:
    如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。

配置映射跟踪的步骤

执行下列步骤以设置映射跟踪级别:

  1. 在系统管理器中,转至“InterChange Server 组件管理”视图,右键单击映射对象,然后单击属性。出现“映射属性页面”(请参阅图 55)。
    图 55. 映射属性页面
  2. 跟踪级别字段中,输入适当的值。
  3. 选择文件 > 保存或按 Ctrl+S 键。

在日志查看器中处理跟踪

要对问题进行故障诊断,可以打开跟踪。跟踪消息帮助您监视在 InterChange Server Express 系统的组件中执行的操作。跟踪级别定义写入跟踪文件的详细信息的数量。跟踪级别越高,您接收的信息越详细。

缺省情况下,由于跟踪生成比您通常所需的更详细的消息,所以跟踪是关闭的。当 InterChange Server Express 在运行时,可以按需要打开和关闭跟踪。

有关跟踪的背景信息,请参阅跟踪文件。有关跟踪的配置信息,请参阅配置记录和跟踪

日志查看器和跟踪的概述

使用日志查看器来显示 InterChange Server Express 的跟踪信息。除显示协作的调试跟踪信息之外,它还允许您在业务对象从一个处理点传递至另一个处理点时查看该业务对象的进展,例如,当业务对象退出协作处理点而被发送至其它协作或连接器进行处理或进入至映射阶段进行数据转换时。有关流跟踪的信息,请参阅业务对象跟踪(流跟踪)

OS/400

当使用日志查看器来查看日志时,您必须将日志文件从 OS/400 复制到 Windows 系统,或将网络驱动器映射至 OS/400 系统,然后浏览至日志文件。

InterChange Server Express 系统消息记录用来传达消息、组件状态更改和故障。

注:
日志查看器查看日志文件,因此不需要运行 InterChange Server Express。InterChange Server Express 系统管理员必须已设置适当的文件系统许可权才能查看日志文件。

可以通过以下其中一种方法查看包含消息和系统消息的说明的日志文件:

日志查看器允许您查看日志文件中包含的所有消息。可以排序和过滤输出显示,并可以打印、保存该文件和以电子邮件的方式发送该文件。

显示在日志查看器中的样本日志文件显示在图 56 中。

图 56. 日志查看器

启动日志查看器的步骤

执行以下其中一个步骤来启动日志查看器:

设置日志查看器首选项的步骤

执行下列步骤来设置“日志查看器”首选项:

  1. 单击编辑 > 首选项

    出现“用户配置选项”对话框,已选择常规选项卡(请参阅图 57)。

    图 57. 日志查看器“用户配置选项”对话框,“一般属性”选项卡
  2. 打开操作下,选择在打开日志文件时显示日志文件的方式:
  3. 要更改日志查看器消息的背景色和字体,单击格式选项卡。

    出现“格式”选项卡(请参阅图 58)。

    图 58. 日志查看器“用户配置选项”,“格式”选项卡
  4. 选择用于显示各种类型的日志消息的选项:
  5. 要更改显示哪些日志查看器列,单击选项卡。

    “列”选项卡打开(请参阅图 59)。

    图 59. 日志查看器“用户配置选项”,“列”选项卡

    此窗口允许您确定在日志查看器中显示哪些列:

日志查看器显示选项的概述

查看菜单包含其它用于更改日志查看器显示方式的选项:

日志查看器显示输出的概述

有几个选项可用于处理日志查看器输出。在文件菜单中,有一些选项可用于打印预览、打印、保存、刷新屏幕、发送至电子邮件收件人和确定页面设置、页眉和页脚的样式。页眉和页脚的变量是:

$F
文件名
$A
应用程序名
$P
页码
$N
总页数
$D
日期(可以后跟附加参数(例如 $D{%y:%h:%m}))

过滤消息的步骤

执行下列步骤来过滤日志查看器中的消息:

  1. 单击查看 > 过滤 > 使用过滤器。出现“过滤器设置”对话框。“过滤器设置”对话框显示对应于记录消息格式的参数的类别(有关参数的描述性列表,请参阅表 18)。
  2. 选择设置过滤器下的某个选项卡以显示要用于过滤消息的项。例如,选择 BusObj 选项卡以显示要在过滤中使用的业务对象的列表,如果要根据消息的时间戳记进行过滤,则还要选择“时间”。可以设置多个过滤器,并可单独地使用它们或将它们与另一个一起使用。
  3. 在显示的项列表中,选择要在日志查看器中查看其消息的每个项。例如,如果您要查看仅与“成本”和“客户”业务对象相关的消息,则仅在列表中选择那些业务对象。如果要仅查看时间戳记在 2002 年 3 月 5 日上午 9 点和 2002 年 3 月 6 日上午 5 点期间的消息,则在时间选项卡下选择那些时间的范围。

    可以使用列表框下面的按钮来选择所有显示的项、清除所有显示的项或反向选择当前选择的选项。

  4. 激活过滤器下,选择要激活的每种过滤器类型的复选框。例如,如果要查看“成本”和“客户”业务对象 ( 这是在先前步骤中指定的 ) 的所有消息,则仅激活 BusObj 过滤器。如果要仅查看“成本”和“客户”业务对象的消息,且这些对象都具有特定的时间戳记,则激活 BusObj 过滤器和“时间”过滤器。
  5. 单击确定。“过滤器设置”对话框关闭且日志查看器刷新,以仅显示被允许通过过滤器的消息。

注意,除根据类别过滤之外,还可以仅显示包含特定文本字符串的消息。为此,在设置过滤器下单击消息,输入您要显示其消息的特定文本,并在激活过滤器下选择消息复选框。

跟踪业务对象流的步骤

对业务对象或访问流进行流跟踪允许您在其生命周期内的每个处理点始终跟踪其进展。使用日志查看器,可以通过检查所显示的跟踪消息来跟踪进展。每个业务对象都具有一个与其相关联的流启动程序标识来用于此目的。如果您按流启动程序标识和日期/时间来排序日志查看器的显示内容,则将把业务对象的跟踪消息组合在一起,以便可以容易跟踪其状态。按升序或降序排序来决定先查看历史透视图还是最新事件。

注:
仅当业务对象在 InterChange Server Express 的域之内时,才执行流跟踪,即从源应用程序的连接器控制器至目标应用程序的连接器控制器。当连接器代理程序或应用程序在处理业务对象时,不执行业务对象流跟踪。

执行下列步骤来跟踪业务对象流:

  1. 如有必要,设置跟踪日志文件目标(请参阅配置记录和跟踪)。
  2. 选择要跟踪的起源触发业务对象(不是通用业务对象)并设置其跟踪级别(请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤)。
  3. 将某个事件从源连接器发送至目标连接器。
  4. 打开日志查看器(请参阅启动日志查看器的步骤)。
  5. 设置显示首选项以查看流跟踪(请参阅日志查看器显示选项的概述)。
  6. 单击 MsgID 列中的任何错误消息按钮以查看消息的文本。
  7. 单击 BusObj 列中的任何业务对象名按钮以查看业务对象中包含的数据。

    此操作使用业务对象查看器,该查看器允许您将数据保存至单独的文件。然后可以通过映射工具或测试连接器读取该文件。

Copyright IBM Corp. 2004, 2005