用于自主计算的通用日志适配器 - 发行说明

已知问题和变通方法

  1.0 连续运行通用日志适配器时最后一个记录未处理
  1.1 在 UNIX 上解析 WebSphere Application Server 日志时的局限性
  1.2 在 UNIX 上解析 WebSphere MQ 错误日志时的局限性
  1.3 使用 runregex_showlog_example.bat/sh 解析日志文件时出现问题
  1.4 解析某些日志时生成了错误的时区信息
  1.5 生成了无效的扩展数据元素
  1.6 通用日志适配器脚本在 z/OS 上不可读
  1.7 通用日志适配器记录信息和局限性
  1.8 未验证日志文件类型
  1.9 解析 WebSphere Application Server activity.log 文件时的局限性
  1.10 解析不同语言环境中生成的日志文件时的局限性
  1.11 使用 Windows XP 解压缩实用程序进行解压缩时出现问题
  1.12 使用相应的静态解析器监视 WebSphere Application Server activity.log 文件和 IBM HTTP Server 错误日志文件时的局限性
  1.13 对具有不是唯一的三字母时区符号的日志文件进行解析时可能会返回错误的事件创建时间

TPTP V3.3 发行说明中提供了与 TPTP 通用日志适配器相关联的更多自述文件信息。

1.0 连续运行通用日志适配器时最后一个记录未处理

当通用日志适配器连续监视日志文件时,如果未指定结束模式,则该适配器不会处理最后一个记录。仅当通用日志适配器关闭时,才会处理最后一个记录。

为确保在监视期间处理最后一个记录,在通用日志适配器配置文件中提供记录的结束模式。

1.1 在 UNIX 上解析 WebSphere Application Server 日志时的局限性

在 UNIX 平台上使用通用日志适配器解析 WebSphere Application Server 二进制活动或服务日志时,用户的特权必须相当于或超过 WebSphere Application Server 的安装者。

要解除此局限性,应在解析该日志之前,使用与通用日志适配器的用户相同的特权将二进制活动或服务日志移至目录。

1.2 在 UNIX 上解析 WebSphere MQ 错误日志时的局限性

在 UNIX 平台上使用通用日志适配器解析 WebSphere MQ 错误日志时,用户的特权必须相当于或超过 WebSphere MQ 的安装者。

要解除此局限性,应在解析日志之前,使用与通用日志适配器的用户相同的特权将 MQ 错误日志移至目录。

1.3 使用 runregex_showlog_example.bat/sh 解析日志文件时出现问题

尝试使用 runregex_showlog_example.bat 和 runregex_showlog_example.sh 解析 WebSphere Application Server 活动日志时,找不到 WebSphere Application Server showlog 实用程序。

要解决此问题,在规则编辑器中编辑 regex_showlog_example.adapter 文件,然后将传感器转换器属性更新为指向 WebSphere Application Server 的正确目录位置。

1.4 解析某些日志时生成了错误的时区信息

解析某些日志时生成了错误的时区信息。

只有日志文件中的时间戳记包含时区信息时,才会生成 creationTime 值中带有正确时区的解析数据。如果日志文件中的时间戳记不包含时区信息,则通用日志适配器生成的 creationTime 值的时区信息将是错误的。

1.5 生成了无效的扩展数据元素

如果没有匹配名称、类型或值的规则,通用日志适配器将对该日志记录生成无效 extendedDataElement 公共基本事件元素。如果没有从该日志记录中解析名称或类型,则将不会生成 extendedDataElement,但通用日志适配器将生成只具有值字段的 extendedDataElement。

要解决此问题,确保提供一个规则,使 extendedDataElement 的名称、值和类型所有这三个字段相匹配。

1.6 通用日志适配器脚本在 z/OS 上不可读

在 z/OS 上解压缩 runtime.zip 和 rules.zip 有时会产生不可读的脚本文件。

为避免此问题,在 z/OS 系统上解压缩 runtime.zip 和 rules.zip 时一定要遵循以下过程。

unzip -a runtime.zip
unzip -a rules.zip
unzip -o rules.zip *.adapter
unzip -o runtime.zip *.xsd

1.7 通用日志适配器记录信息

在 Eclipse 环境外部执行通用日志适配器时,该适配器会将消息和错误记录至名为 hgla.log 的文件。以单机方式执行时,将在当前工作目录中创建 hgla.log 文件。使用“日志和跟踪分析器”作为远程日志导入操作的一部分执行时,hgla.log 文件将位于远程系统上的一个临时目录中,该临时目录是在代理控制器配置文件 serviceconfig.xml 中的 SYS_TEMP_DIR 变量中指定的。例如,如果是在 UNIX 或 Linux 系统上运行,则 hgla.log 文件将位于 /tmp/var/tmp 目录中;如果是在 Windows 系统上运行,该文件将位于 c:\Documents and Settings\userid\Local Settings\Temp 目录中。

在 Eclipse 环境中执行(例如,使用“日志和跟踪分析器”作为本地日志导入操作的一部分)时,通用日志适配器将把消息和错误记录至 Eclipse 工作目录的 .metadata\.plugins\org.eclipse.hyades.logging.adapter 目录中的 hgla.log 文件。

通用日志适配器使用记录级别 10、20、30、50 和 60 来记录事件。可将 hgla.log 文件导入到“日志和跟踪分析器”中来诊断通用日志适配器在解析该日志文件时遇到的问题。

1.8 未验证日志文件类型

通用日志适配器未进行任何验证以确定要解析的日志文件的类型是否与适配器文件配置相匹配。例如,如果适配器文件的传感器配置中指定的日志文件并非解析器配置中抽取器配置和替换规则所期望的类型, 可能会产生不可预测的结果。解析可能会成功,而且没有任何错误,但生成的公共基本事件数据将会不正确。解析也可能会失败,显示的错误消息指示遇到了不正确的数据。

要解决此问题,确保在传感器组件配置中指定的日志文件的类型是正确的。

1.9 解析 WebSphere Application Server activity.log 文件时的局限性

在非英语机器上使用 runregex_showlog_example.bat/sh 来解析二进制 WebSphere Application Server 活动日志文件时,日志记录数据将无法成功映射至公共基本事件。而是,某些日志记录数据可能会出现在公共基本事件的不正确字段中。

1.10 解析不同语言环境中生成的日志文件时的局限性

当解析包含时间戳记的日志文件(该时间戳记所处的语言环境不同于通用日志适配器执行所处的语言环境),并且使用基于规则的适配器文件(它被配置为使用 creationTime 的替换规则中的 Time Format 属性)时,可能无法正确解析时间戳记和其它日志记录数据。例如,在日语机器上使用 config\IHS\access\v1.3.19.3\runregex_example.bat/sh 解析 IBM HTTP Server 访问日志文件时,生成的公共基本事件中的 creationTime 值将为零,并且公共基本事件消息字段将为空白。

要解决此问题,通过向 Java 命令添加下列 JVM 参数来更改 runregex_example.bat/sh 文件:

-Duser.language=2-char-language-code -Duser.region=2-char-country-code

其中语言和国家或地区代码表示时间戳记所处的语言环境。对于提到的示例,JVM 参数应为:

-Duser.language=en -Duser.region=US

或者,通过在相关联的“上下文实例”属性中为时间戳记语言环境指定语言和国家或地区代码来更改基于规则的适配器文件。

1.11 使用 Windows XP 解压缩实用程序进行解压缩时出现问题

在 Windows XP 上安装通用日志适配器时,如果使用 Windows XP 本机的解压缩实用程序来解压缩通用日志适配器 rules.zip 文件,则将出现问题。某些目录和文件不会解压缩。这一问题将导致无法使用通用日志适配器来解析某些日志文件类型。为解决此问题,在 Windows XP 上进行安装时使用另一解压缩实用程序,如 WinZip 或 UnZip。

1.12 使用相应的静态解析器监视 WebSphere Application Server activity.log 文件和 IBM HTTP Server 错误日志文件时的局限性

使用相应的静态解析器连续解析 IBM WebSphere Application Server 活动日志和 IBM HTTP Server 错误日志文件有时会导致记录从已解析的输出中丢失。特别是,当对日志文件追加新的记录时,不会解析追加的记录的第一个记录,并且第一个记录也不会包括在已解析的输出中。当在日志的静态适配器配置文件中使用 continuousOperation="true" 配置了上下文实例时就会产生此问题。要解决此问题,可通过使用 continuousOperation="false" 配置上下文实例来解析日志文件,或者使用基于规则的适配器来进行连续监视。

1.13 对具有不是唯一的三字母时区符号的日志文件进行解析时可能会返回错误的事件创建时间

当使用日志适配器来将使用三字母时区符号的日志文件转换为 CBE 格式时,如果三字母时区符号不是唯一的,则可能会导致日志事件的创建时间不正确。例如,可以将三字母符号“IST”解释为 Israeli Standard Time、Indian Standard Time、Iran Standard Time 或 Irish Summer Time。

返回到主自述文件

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.