Generic Log Adapter V6.0.1 - 自述文件

已知问题和变通方法

  1.0 当 Generic Log Adapter 持续运行时,不处理最后一个记录
  1.1 在 UNIX 上对 WebSphere Application Server 日志进行语法分析时的限制
  1.2 在 UNIX 上对 WebSphere MQ 错误日志进行语法分析时的限制
  1.3 使用 runregex_showlog_example.bat/sh 对日志文件进行语法分析时的问题
  1.4 对一些日志进行语法分析生成错误的时区信息
  1.5 生成无效的扩展数据元素
  1.6 Generic Log Adapter 脚本在 z/OS 上不可读
  1.7 Generic Log Adapter 日志记录信息和限制
  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 Generic Log Adapter 关联的其他自述信息可在 TPTP V3.3 发行说明中获取。

1.0 当 Generic Log Adapter 持续运行时,不处理最后一个记录

当 Generic Log Adapter 持续监视某个日志文件时,如果未指定结束模式,则它将不处理最后一个记录。仅当 Generic Log Adapter 关闭时才将处理最后一个记录。

为确保监视期间处理最后一个记录,请在 Generic Log Adapter 配置文件中为记录提供结束模式。

1.1 在 UNIX 上对 WebSphere Application Server 日志进行语法分析时的限制

在 UNIX 平台上使用 Generic Log Adapter 对 WebSphere Application Server 二进制活动或服务日志进行语法分析时,用户的特权必须等于或大于 WebSphere Application Server 安装者的特权。

为解决此限制,应在对日志进行语法分析前,将二进制活动或服务日志移动到具有与 Generic Log Adapter 用户相同特权的目录中。

1.2 在 UNIX 上对 WebSphere MQ 错误日志进行语法分析时的限制

在 UNIX 平台上使用 Generic Log Adapter 对 WebSphere MQ 错误日志进行语法分析时,用户的特权必须等于或大于 WebSphere MQ 安装者的特权。

为解决此限制,请在对日志进行语法分析前,将 MQ 错误日志移动到具有与 Generic Log Adapter 用户相同特权的目录中。

1.3 使用 runregex_showlog_example.bat/sh 对日志文件进行语法分析时的问题

尝试使用 runregex_showlog_example.bat 和 runregex_showlog_example.sh 对 WebSphere Application Server 活动日志进行语法分析时,无法找到 WebSphere Application showlog 实用程序。

为解决此问题,请在规则编辑器中编辑文件 regex_showlog_example.adapter,然后更新 Sensor Converter 属性,使它指向 WebSphere Application Server 的正确目录位置。

1.4 对一些日志进行语法分析生成错误的时区信息

对一些日志进行语法分析生成错误的时区信息。

只有在日志文件带有包含时区信息的时间戳记时,才会以具有正确时区的 creationTime 值生成语法分析数据。如果日志文件中的时间戳记不包含时区信息,则 Generic Log Adapter 将生成带有错误时区信息的 creationTime 值。

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

如果没有规则与名称或类型值匹配,则 Generic Log Adapter 将为日志记录生成无效的 extendedDataElements 公共基本事件元素。如果没有从日志记录分析得出名称或类型,则不应生成 extendedDataElement,但是 Generic Log Adapter 将生成仅带值字段的 extendedDataElement。

为解决此问题,请确保提供使 extendedDataElement 所有三个字段(名称、值和类型)都匹配的规则。

1.6 Generic Log Adapter 脚本在 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 Generic Log Adapter 日志记录信息

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

在 Eclipse 环境内执行时(例如使用日志和跟踪分析器作为本地日志导入操作的一部分执行),Generic Log Adapter 会将消息和错误记录到位于 Eclipse 工作空间目录内 .metadata\.plugins\org.eclipse.hyades.logging.adapter 目录下的 hgla.log 文件中。

Generic Log Adapter 会记录日志记录级别为 10、20、30、50 和 60 的事件。可以将 hgla.log 文件导入到日志和跟踪分析器中,以诊断 Generic Log Adapter 在对日志文件进行语法分析时遇到的问题。

1.8 不对日志文件类型进行验证

Generic Log Adapter 不执行验证来确定正在进行语法分析的日志文件的类型是否与适配器文件配置匹配。例如,如果适配器文件中传感器配置所指定的日志文件不是解析器配置中抽取器配置和替换规则所适用的类型,则可能发生不可预测的结果。语法分析可能成功并且没有错误,但是生成的公共基本事件数据将不正确。语法分析也可能失败,并有错误消息指出遇到错误数据。

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

1.9 对 WebSphere Application Server activity.log 文件进行语法分析时的限制

在非英语的机器上使用 runregex_showlog_example.bat/sh 对二进制 WebSphere Application Server 活动日志文件进行语法分析时,日志记录数据将不能成功映射到公共基本事件。而是一些日志记录数据可能显示在公共基本事件的错误字段中。

1.10 对不同语言环境中生成的日志文件进行语法分析时的限制

对包含的时间戳记与正在执行的 Generic Log Adapter 不在相同语言环境中的日志文件进行语法分析,并使用基于规则的适配器文件(配置为对 creationTime 使用替换规则中的“时间格式”属性)时,时间戳记和其他日志记录数据可能无法正确地进行语法分析。例如在日语机器上使用 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 上安装 Generic Log Adapter 时,使用 Windows XP 本机解压缩实用程序解压缩 Generic Log Adapter rules.zip 文件会有问题。一些目录和文件将不会被解压缩。此问题会导致一些日志文件类型无法使用 Generic Log Adapter 进行语法分析。为解决此问题,在 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.

返回到主自述文件

版权和声明