本节描述如何使用日志和跟踪文件进行故障诊断。包括以下主题:
记录用来传递系统消息、组件状态更改、故障和跟踪信息。从 InterChange Server Express、协作对象和连接器生成的消息被发送至您安装 InterChange Server Express 时指定的目标,缺省情况下为 STDOUT(标准输出)。从连接器代理程序生成的消息被发送至 STDOUT,但可以配置为发送至位于代理程序位置的单独日志文件中。
消息传递系统始终处于活动状态并准确监视系统。
除标准输出之外,还可以将消息传递系统配置为将消息发送至日志文件或电子邮件收件人。可以为日志文件配置备份文件(归档文件),并可以确定它们的大小。当出现问题且需要详细信息进行故障诊断时,可以配置跟踪(由于它影响系统资源,因此缺省情况下禁用跟踪)。
有两个工具提供了用于配置和查看消息记录和跟踪的图形用户界面:
除了使用日志查看器来查看日志之外,还可以使用文本编辑器来打开日志或创建自己的工具来过滤日志文件。
有关使用日志查看器来查看记录和跟踪消息的信息,请参阅日志查看器和跟踪的概述。
本节包括以下主题:
协作对象可以生成消息来报告运行时信息、警告和错误。例如,协作可以记录其决策点和操作的结果。
当 InterChange Server Express 执行协作对象时,它将其消息写至其日志。有关配置系统记录的信息,请参阅"配置记录和跟踪"。
另外,还可以通过电子邮件将协作对象的消息发送至一个或多个收件人。可以为每个协作对象单独指定一组电子邮件收件人。有关使用电子邮件通知的规则的信息,参阅"配置日志消息的电子邮件通知"。
连接器消息被发送至 InterChange Server Express 消息目标。视操作系统而定,消息以下列方式的其中一种方式出现:
有关连接器记录的信息,请参阅"连接器代理程序日志"。
为了帮助进行故障诊断,在连接器代理程序引导期间创建了一个临时日志文件,它包含从连接器控制器获取的元数据。该元数据由业务对象规范、属性和支持变化量的属性组成。该文件命名为 connectornametmp.log,它在 ProductDir\Connectors 目录中。
所有消息都经过格式化,所以很容易过滤。InterChange Server Express 和连接器的已记录消息使用相同格式,该格式在表 15 中进行了描述。当配置业务对象以获取流跟踪消息时,它们使用这些字段和其它字段(在表 15 中由星号表示)。传递至 InterChange Server Express 的消息具有以下格式,使用以下某些或全部参数:
Time: System Name: Thread: MsgType MsgID:
SubSystem: FIID: BO: MsgText: BOD:
变量 | 描述 |
---|---|
Time | 时间戳记:以时间格式 year/month/date 表示的记录日期 |
System | 组件的类型(系统标识)。它可以是服务器、协作、业务对象或连接器代理程序。 |
Thread | 线程名称和线程标识 |
Name | 组件的名称,如 ClarifyConnector。 |
MsgType | 消息的严重性。请参阅表 16。 |
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]
表 16 描述 InterChange Server Express 消息的类型。
类型 | 描述 |
---|---|
信息 | 仅供参考。不需要执行操作。 |
警告 | InterChange Server Express 选择的缺省条件。 |
错误 | 您应调查的严重问题。 |
致命错误 | 停止操作且应报告的错误。 |
跟踪 | 所指定跟踪级别的跟踪信息。 |
流跟踪 | 业务对象的流跟踪信息。 |
内部错误 | 应调查的严重内部问题。 |
内部致命错误 | 停止操作的内部错误。应报告它。 |
InterChange Server Express 可以将消息记录至以下目标:
除管理定期记录之外,InterChange Server Express 还可以在生成错误或致命错误消息时将电子邮件消息发送至指定的用户。
缺省情况下,跟踪消息被发送至系统日志文件。在某些情况下,此文件可能变得太大,因此建议您指定单独的跟踪文件。有关为跟踪消息设置单独文件的指示信息,请参阅"跟踪文件"。
配置记录和跟踪描述如何设置记录目标。
要指定电子邮件通知的收件人,请参阅配置日志消息的电子邮件通知。
日志/跟踪文件管理描述如何避免使日志文件变得太大。
连接器代理程序和连接器控制器具有各自的记录机制。本节描述连接器代理程序记录。连接器控制器消息被发送至包含 InterChange Server Express 消息的日志。
连接器代理程序将消息记录至本地目标并且还可以将其消息发送至 InterChange Server Express 进行记录。要指定日志文件名,编辑连接器的 LogFileName 属性(使用连接器配置器)并插入要使用的日志文件的名称。
如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。
缺省日志文件(位于 STDOUT 中)包含来自连接器的错误和参考消息的文本。Name 是应用程序的名称。
表 17 描述可以编辑的属性,它们确定连接器代理程序将消息记录至何处。
属性名 | 描述 | 值的类型 |
---|---|---|
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)。图 48 显示使用此配置的文件的进行情况。
有关详细信息,请参阅配置任务配置记录和跟踪。
如果系统日志文件配置为无限制的大小,则 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 版》。可以在系统管理器的“编辑配置”工具中更新这些参数的设置,如配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤中所述。
可以跟踪协作对象的执行情况。跟踪将有关协作对象的执行情况的详细消息写至在 InterchangeSystem.cfg 文件中指定的日志目标。跟踪协作是持久的。协作有两个跟踪级别设置:系统级别和协作级别。
系统级别跟踪返回协作的运行时信息。例如,如果要跟踪协作的状态更改,则将系统跟踪级别设置为 3。
可以将协作对象跟踪设置为以下其中一个级别:
跟踪级别 | 描述 |
---|---|
1 | 跟踪从连接器接收业务对象的情况和适当方案的启动。 |
2 | 打印级别 1 的消息。另外,还跟踪每个方案的启动和完成,并报告向前执行和回滚。 |
3 | 打印级别 1 和 2 的消息。另外,还跟踪每个方案决策块或操作的执行。 |
4 | 打印级别 1 至 3 的消息。另外,还跟踪每个方案发送和接收每个业务对象的情况。 |
5 | 打印级别 1 至 4 的消息。另外,还跟踪每个方案发送和接收每个业务对象的情况,并打印业务对象中每个属性的值。 |
有关配置指示信息,请参阅"配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤"。
连接器包含两个组件:连接器控制器和连接器代理程序。这两个组件可以在网络上的不同位置且可以用不同方式跟踪。
可以将连接器代理程序和控制器跟踪设置为以下级别之一:
跟踪级别 | 描述 |
---|---|
1 | 跟踪初始化和业务对象的发送和接收。 |
2 | 打印级别 1 的消息,另外,还为相同类型的事件提供比级别 1 更多的详细信息。 |
3 | 打印级别 1 和 2 的消息。另外,还跟踪连接器代理程序和消息传递驱动程序之间的消息交换。 |
4 | 打印级别 1 至 3 的消息。另外,还跟踪连接器的内部级别之间的业务对象的传递。 |
5 | 打印级别 1 至 4 的消息。另外,还跟踪连接器的内部级别之间的管理消息的传递。 |
新的或更改的跟踪级别立即生效。
如果您要为连接器代理程序指定记录和跟踪文件,则当启动该代理程序时必须指定本地配置文件。
有关配置指示信息,请参阅"配置连接器跟踪的步骤"。
您可以使用系统管理器来设置映射跟踪。跟踪映射对于调试和跟踪信息以及由映射创建的错误消息很有用。缺省情况下,映射跟踪处于关闭状态。
有关跟踪映射的更多信息,请参阅 Map Development Guide。有关配置指示信息,请参阅"配置映射跟踪的步骤"。
业务对象跟踪记录提供了一种跟踪业务对象的进行情况的方式,该方式基于在每个处理点生成的通知消息,从一个处理点到另一个处理点进行跟踪。例如,对于级别 2 跟踪,当业务对象到达协作以进行处理时,将记录一条跟踪消息。
表 20 描述与业务对象跟踪相关联的可配置的级别:
跟踪级别 | 描述 |
---|---|
0 | 不跟踪。 |
1 | 事件状态(如成功或失败)和事件标识信息。 |
2 | 最小事件跟踪。关于业务对象何时进入/退出系统(如连接器、映射、关系和协作)的信息。包括级别 1 信息。 |
3 | 提供来自级别 2 的事件跟踪和进入/退出系统时的业务对象转储。系统性能受影响。 |
4 | 详细的跟踪。提供对系统组件(如连接器、映射、关系和协作)的跟踪并将这些跟踪映射至级别 3 事件跟踪。此级别的跟踪会影响系统性能。 |
有关配置指示信息,请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤。
提供两个级别的 Web 网关跟踪:最小和最大。此跟踪允许您查看关于是否在网关上正确地执行通信处理的信息。通过网关配置工具设置网关跟踪级别。有关指示信息,请参阅 System Implementation Guide。
表 21 描述与网关跟踪相关联的可配置的级别:
跟踪级别 | 描述 |
---|---|
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,等等。
执行下列步骤来在系统级别配置电子邮件通知:
“系统管理器”窗口的右上部分变成一个工具,您可以在其中编辑 InterchangeSystem.cfg 文件。
在“系统管理器”窗口的右上部分出现一个对话框,在该窗口中,您可以输入在系统级别配置电子邮件通知所必需的参数(请参阅图 49)。
执行以下操作:
执行以下操作:
执行下列步骤来设置接收协作消息的电子邮件地址:
出现“属性”对话框。
您可以为特定连接器配置电子邮件通知,然而,在协作对象级别设置的配置参数将取代在系统级别设置的配置参数。
执行下列步骤来为特定连接器配置电子邮件通知:
出现“连接器配置器易捷版”窗口。
本节描述如何设置消息记录和跟踪。可以通过使用系统管理器中的“编辑配置”选项和通过手工编辑 InterchangeSystem.cfg 文件来进行这些设置。将描述以下任务:
"配置 InterChange Server Express 记录和跟踪目标的步骤"
配置其它 InterChange Server Express 记录和跟踪参数的步骤
配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤
要使用“编辑配置”工具,InterChange Server Express 必须正在运行并处于“已连接”状态。“编辑配置”工具在每个会话中只能管理一个 InterChange Server Express。
执行下列步骤来打开“编辑配置”工具:
当配置这些设置时,请牢记有关 STDOUT 的以下信息:
Linux |
---|
如果将记录和跟踪设置为至 STDOUT,则消息被自动重新路由至 $PRODUCTDIR/logs/ics_manager.log。 |
OS/400 |
---|
如果您将记录和跟踪设置为至 STDOUT,则消息将写入与服务器作业相关联的假脱机文件中。 |
Windows |
---|
如果计划以服务的形式运行 InterChange Server,您必须将记录和跟踪设置为至文件目标。将记录和跟踪设置为至 STDOUT 会防止将 InterChange Server 配置为 Windows 服务。 |
执行下列步骤来配置 InterChange Server Express 消息记录和跟踪的目标:
出现记录和跟踪配置窗口(请参阅图 50)。
如果选择将消息记录至 STDOUT,则消息以下列其中一种方式出现:
Linux |
---|
如果将记录和跟踪设置为至 STDOUT,则消息被自动重新路由至 $PRODUCTDIR/logs/ics_manager.log。 |
Windows |
---|
STDOUT 出现在启动 InterChange Server 的“命令提示符”窗口中。 |
您的更改立即生效,如果您已配置了日志文件,则将保存它并注明日期,并使用新输入的配置创建一个新文件。
当启用了 InterChange Server Express 堆栈跟踪时,堆栈跟踪信息将打印至 InterChange Server Express 日志文件。此信息可用于对新安装的系统进行故障诊断。
执行下列步骤来配置堆栈跟踪功能:
执行下列步骤来为日志文件和跟踪文件设置文件大小和归档文件数:
两个连接器组件都具有各自的记录机制。连接器控制器记录被发送至 InterchangeServer.log 文件。本节描述如何配置连接器代理程序日志文件名和位置。
有关连接器代理程序记录的背景信息,请参阅"连接器代理程序日志"。
可以使用以下其中一种方法来设置连接器代理程序记录的目标:
执行下列步骤以使用连接器配置器易捷版来配置连接器代理程序记录的目标:
例如,将 LogAtInterchangeEnd 值更改为 true 以将消息发送至 InterChange Server Express 日志。如果将 InterChange Server Express 配置为当记录错误和致命消息时发送电子邮件,则也为连接器代理程序消息发送电子邮件。
例如,要将连接器代理程序消息发送至消息文件而不是缺省值 STDOUT,则在值字段中输入文件的全路径名。
执行下列步骤来配置跟踪:
设置这些跟踪级别会更新 InterchangeSystem.cfg 文件中的参数。有关在各个跟踪级别生成哪些信息的指示信息,请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》。
有关协作的跟踪级别的描述,请参阅协作对象跟踪。
子系统、业务对象和协作的跟踪级别立即生效。
本节描述可以用来配置协作对象跟踪级别的两种方法之一。有关备用方法的信息,请参阅配置 InterChange Server Express、业务对象和协作的跟踪级别的步骤。
执行下列步骤来配置协作对象跟踪级别:
只要协作对象的跟踪级别一更改,协作对象就会启动跟踪。
执行下列步骤来配置连接器跟踪:
对这些属性的更改立即生效。无论 InterChange Server Express 将其跟踪消息发送至何处,都会出现连接器控制器的跟踪消息,无论连接器代理程序在何处记录消息,都会出现连接器代理程序的跟踪消息。
执行下列步骤以设置映射跟踪级别:
要对问题进行故障诊断,可以打开跟踪。跟踪消息帮助您监视在 InterChange Server Express 系统的组件中执行的操作。跟踪级别定义写入跟踪文件的详细信息的数量。跟踪级别越高,您接收的信息越详细。
缺省情况下,由于跟踪生成比您通常所需的更详细的消息,所以跟踪是关闭的。当 InterChange Server Express 在运行时,可以按需要打开和关闭跟踪。
有关跟踪的背景信息,请参阅跟踪文件。有关跟踪的配置信息,请参阅配置记录和跟踪。
使用日志查看器来显示 InterChange Server Express 的跟踪信息。除显示协作的调试跟踪信息之外,它还允许您在业务对象从一个处理点传递至另一个处理点时查看该业务对象的进展,例如,当业务对象退出协作处理点而被发送至其它协作或连接器进行处理或进入至映射阶段进行数据转换时。有关流跟踪的信息,请参阅业务对象跟踪(流跟踪)。
OS/400 |
---|
当使用日志查看器来查看日志时,您必须将日志文件从 OS/400 复制到 Windows 系统,或将网络驱动器映射至 OS/400 系统,然后浏览至日志文件。 |
InterChange Server Express 系统消息记录用来传达消息、组件状态更改和故障。
可以通过以下其中一种方法查看包含消息和系统消息的说明的日志文件:
日志查看器允许您查看日志文件中包含的所有消息。可以排序和过滤输出显示,并可以打印、保存该文件和以电子邮件的方式发送该文件。
显示在日志查看器中的样本日志文件显示在图 53 中。
执行以下其中一个步骤来启动日志查看器:
执行下列步骤来设置“日志查看器”首选项:
出现“用户配置选项”对话框,已选择常规选项卡(请参阅图 54)。
出现“格式”选项卡(请参阅图 55)。
“列”选项卡打开(请参阅图 56)。
此窗口允许您确定在日志查看器中显示哪些列:
查看菜单包含其它用于更改日志查看器显示方式的选项:
单击每个排序字段中的向下箭头来选择日期/时间、事件标识或业务对象。通过升序或降序来进一步排序。
有几个选项可用于处理日志查看器输出。在文件菜单中,有一些选项可用于打印预览、打印、保存、刷新屏幕、发送至电子邮件收件人和确定页面设置、页眉和页脚的样式。页眉和页脚的变量是:
执行下列步骤来过滤日志查看器中的消息:
可以使用列表框下面的按钮来选择所有显示的项、清除所有显示的项或反向选择当前选择的选项。
注意,除根据类别过滤之外,还可以仅显示包含特定文本字符串的消息。为此,在设置过滤器下单击消息,输入您要显示其消息的特定文本,并在激活过滤器下选择消息复选框。
对业务对象或访问流进行流跟踪允许您在其生命周期内的每个处理点始终跟踪其进展。使用日志查看器,可以通过检查所显示的跟踪消息来跟踪进展。每个业务对象都具有一个与其相关联的流启动程序标识来用于此目的。如果您按流启动程序标识和日期/时间来排序日志查看器的显示内容,则将把业务对象的跟踪消息组合在一起,以便可以容易跟踪其状态。按升序或降序排序来决定先查看历史透视图还是最新事件。
执行下列步骤来跟踪业务对象流:
此操作使用业务对象查看器,该查看器允许您将数据保存至单独的文件。然后可以通过映射工具或测试连接器读取该文件。