通用日志适配器 - 发行说明

已知问题和变通方法

1.0 通用日志适配器
  1.1 连续运行通用日志适配器时最后一个记录未处理
  1.2 调用通用日志适配器配置文件时出现问题
  1.3 在 UNIX 上解析 WebSphere Application Server 日志时的局限性
  1.4 在 UNIX 上解析 WebSphere MQ 错误日志时的局限性
  1.5 使用 runregex_showlog_example.bat/sh 解析日志文件时出现问题
  1.6 DB2 诊断日志规则解析器返回了错误的数据
  1.7 解析某些日志时生成了错误的时区信息
  1.8 生成了无效的扩展数据元素
  1.9 通用日志适配器脚本在 z/OS 上不可读
  1.10 *通用日志适配器 AIX errpt 示例脚本 runregex_errpt_example.sh 在 AIX 上不起作用
  1.11 不支持使用静态解析器连续监视日志文件
  1.12 通用日志适配器记录信息和局限性
  1.13 未验证日志文件类型
  1.14 解析 WebSphere Application Server activity.log 文件时的局限性
  1.15 解析不同语言环境中生成的日志文件时的局限性
  1.15 运行静态解析器适配器文件时编辑器窗格是空的
  1.17 使用 Windows XP 解压缩实用程序进行解压缩时出现问题

1.0 通用日志适配器

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

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

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

1.2 调用通用日志适配器配置文件时出现问题

如果使用 gla.bat 批处理文件调用通用日志适配器配置文件,则该配置文件被不正确地调用。

可通过对配置文件使用绝对路径来解决这一问题。 例如,gla.bat c:\mypathname\static.adapter。

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

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

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

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

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

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

1.5 使用 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.6 DB2 诊断日志规则解析器返回了错误的数据

使用基于规则的适配器配置解析 DB2 诊断日志文件时,解析后的输出中的日志文件消息包括不必要的冒号。

这一问题目前没有变通方法。

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

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

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

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

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

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

1.9 通用日志适配器脚本在 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
*1.10 通用日志适配器 AIX errpt 示例脚本 runregex_errpt_example.sh 在 AIX 上不起作用

通用日志适配器 AIX errpt 示例脚本 runregex_errpt_example.sh 在 AIX 系统上不起作用。

为解决此问题,使用通用日志适配器配置编辑器来编辑 AIX errpt 示例适配器文件 GenericLogAdapter\config\AIX\syslog\v4\regex_errpt_example.adapter 并进行下列更改:

  1. 更改传感器的转换器属性以使其具有属性值 errpt -a >/tmp/errpt.out
  2. 向传感器添加一个新属性,其属性名为 shell,属性值为 sh

注意:这已经在 V6.0.0.1 中进行了修正。

1.11 不支持使用静态解析器来连续监视日志文件

不能使用静态 Java 解析器类来连续监视日志文件。如果有基于规则的解析器,则应使用该解析器来连续监视这些日志文件。

1.12 通用日志适配器记录信息和局限性

在 Eclipse 环境外部执行通用日志适配器时,该适配器会将消息和错误记录至名为 hgla.log 的文件。以单机方式执行时,将在当前工作目录中创建 hgla.log。使用日志和跟踪分析器作为远程导入操作的一部分执行时,如果是在 UNIX 或 Linux 系统上运行,则 hgla.log 将位于远程系统上的 /tmp 目录;如果是在 Windows 系统上运行,该文件将位于 c:\Documents and Settings\userid\Local Settings\Temp 目录。通用日志适配器使用记录级别 10、20、30、50 和 60 来记录事件。可将 hgla.log 文件导入到日志和跟踪分析器中来诊断通用日志适配器在解析该日志文件时遇到的问题。

在 Eclipse 环境中执行(如使用日志和跟踪分析器作为本地日志导入操作的一部分)时,通用日志适配器不会将消息记录至 hgla.log 文件或任何其它位置。

1.13 未验证日志文件类型

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

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

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

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

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

当解析包含时间戳记的日志文件(该时间戳记所处的语言环境不同于通用日志适配器执行所处的语言环境),并且使用基于规则的适配器文件(它被配置为使用 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.16 运行静态解析器适配器文件时编辑器窗格是空的

在通用日志适配器配置编辑器中运行静态解析器适配器文件时,“抽取器结果”和“格式化程序结果”窗格是空的。这是因为静态解析器适配器不包含抽取器和格式化程序组件。但是,如果正确配置了静态解析器适配器文件,“传感器结果”窗格应该包含数据。静态解析器传感器的输出是一些公共基本事件,提供解析过的日志记录。“传感器结果”窗格将包含字符串格式的公共基本事件。如果在单击“重新运行适配器”按钮后“传感器结果”窗格是空的,则单击“抽取器结果”窗格顶部工具栏上的显示日志按钮,这将在“传感器结果”窗格中显示传感器输出。

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

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

返回到主自述文件