通用日志适配器发行说明

© Copyright International Business Machines Corporation 2000, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

已知问题和变通方法

1.0 持续运行通用日志适配器时不会处理最后一条记录
1.1 在 UNIX 上解析 WebSphere Application Server 日志时的局限性
1.2 在 UNIX 上解析 WebSphere MQ 错误日志时的局限性
1.3 使用 runregex_showlog_example.bat/sh 解析日志文件时出现问题
1.5 生成了无效的扩展数据元素
1.7 通用日志适配器记录信息和局限性
1.8 未对日志文件类型进行验证
1.9 解析 WebSphere Application Server activity.log 文件时的局限性
1.10 解析不同语言环境中生成的日志文件时的局限性
1.12 对具有重复三字母时区符号的日志文件进行解析时可能会返回错误的事件创建时间
1.13 为 DB2 Express 诊断日志解析的公共基本事件不符合规范
1.14 解析日志文件时发生适配器验证错误
1.15 解析日志文件时发生格式化程序错误
1.16 解析日志时出现配置问题

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

1.0 持续运行通用日志适配器时不会处理最后一条记录

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

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

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

在 UNIXTM 平台上使用通用日志适配器解析 WebSphere(R) 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.5 生成了无效的扩展数据元素

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

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

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

当通用日志适配器在 Eclipse 环境外部以独立方式运行时,它会将消息和错误记录到当前工作目录中名称为 hgla.log 的文件中。如果 hgla.log 文件在当前工作目录中已存在,则将创建一个名称为 hgla.nnnnnnnn.log 的新日志文件,其中 nnnnnnnn 是唯一编号。如果在进行日志导入操作过程中执行通用日志适配器,则通用日志适配器所记录的错误消息将显示在日志和跟踪分析器的错误对话框中。

在“通用日志适配器”透视图中的 Eclipse 环境中执行时,通用日志适配器所记录的消息和错误将列示在“问题”视图中。

通用日志适配器在记录事件时所使用的记录级别有 5、10、20、30、50 和 60,具体使用哪个级别取决于适配器配置文件中“上下文和组件”的 loggingLevel 设置。可以将 hgla.log 文件作为公共基本事件 XML 文件类型导入至日志和跟踪分析器,以诊断通用日志适配器在解析日志文件时所遇到的问题。

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

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

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

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

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

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

当使用基于规则的适配器文件(它被配置为对 creationTime 使用替换规则中的 Time Format 属性)来解析包含时间戳记的日志文件时,如果该日志文件所处的语言环境与执行通用日志适配器的语言环境不同,则可能无法正确解析时间戳记和其他日志记录数据。例如,生成的公共基本事件中的 creationTime 值可能为零并且“公共基本事件消息”字段可能为空白。

要解决此问题,请确保基于规则的适配器文件中上下文实例的 ISO 语言代码和 ISO 国家或地区代码属性的值与日志文件中要解析的时间戳记的语言环境相对应。

1.12 对具有重复三字母时区符号的日志文件进行解析时可能会返回错误的事件创建时间

当使用通用日志适配器将使用三字母时区符号的日志文件转换为公共基本事件格式时,如果三字母时区符号重复,则可能会导致日志事件的创建时间错误。例如,可以将三字母符号“IST”解释为 Israeli Standard Time、Indian Standard Time、Iran Standard Time 或 Irish Summer Time。

1.13 为 DB2 Express 诊断日志解析的公共基本事件不符合规范

如果使用 % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool 中的适配器来解析 IBM(R) DB2(R) Express 诊断日志,则写入输出文件的已生成公共基本事件将违反某些公共基本事件规范。这是由于用来将 DB2 诊断日志转换为公共基本事件的 db2diag.exe 实用程序中存在错误而引起的。然而这不会影响到解析操作。在修正 db2diag.exe 之前,没有已知的变通方法。

1.14 解析日志文件时发生适配器验证错误

使用通过先前版本的适配器配置编辑器创建的适配器文件解析日志文件时,可能会导致将以下错误消息写入通用日志适配器日志文件 hgla.log

IWAT0383E 适配器验证错误:cvc-complex-type.4:属性
“lineBreakSymbol”必须存在于元素“ex:Extractor”中。

先前版本的适配器配置编辑器创建的适配器文件不包含必需的 Extractor 属性 lineBreakSymbol。即使此属性包含空值,在 Extractor 元素中也必须存在该属性。现在,在使用适配器文件之前,通用日志适配器将根据通用日志适配器模式对它进行验证,而且 lineBreakSymbol 是该模式中的必需属性。

要解决此问题,请在适配器配置编辑器中打开适配器文件,对 Extractor 元素的 lineBreakSymbol 字段添加一个非空值并保存该适配器文件,如果该值不是必需的,则将其删除并再次保存该文件。现在,该适配器文件将在 Extractor 元素中包含 lineBreakSymbol 属性。

1.15 解析日志文件时发生格式化程序错误

使用通过先前版本的适配器配置编辑器创建的适配器文件解析日志文件时,可能会导致将以下错误消息写入通用日志适配器日志文件 hgla.log

IWAT0438E 由于缺少必需属性 sourceComponentId,所以公共基本事件格式化程序 N76D20B0042411D98000E0362B33D6F0 无法创建公共基本事件。

此消息指示:由于缺少公共基本事件的必需属性 sourceComponentId,所以通用日志适配器的格式化程序组件无法创建公共基本事件。现在,通用日志适配器对公共基本事件中存在的所有必需属性进行验证,而且如果缺少属性,就不会返回公共基本事件。适配器文件中可能没有消息中所指示属性的解析规则,或者解析规则不正确。

要解决此问题,请将缺少的必需公共基本事件属性的解析器规则添加到适配器文件,或验证现有规则是否正确。

1.16 解析日志时出现配置问题

解析日志时,可能会将下列错误消息写入控制台:

要解决此问题,请对 gla.bat 和 gla.sh 运行时脚本文件中的 -classpath 选项进行下列更新:



声明

本信息是为在美国提供的产品和服务编写的。

IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息,请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权,任何同等功能的产品、程序或服务,都可以代替 IBM 产品、程序或服务。但是,评估和验证任何非 IBM 产品、程序或服务,则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

有关双字节(DBCS)信息的许可查询,请与您所在国家或地区的 IBM 知识产权部门联系,或用书面方式将查询寄往:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区:INTERNATIONAL BUSINESS MACHINES CORPORATION“按现状”提供本出版物,不附有任何种类的(无论是明示的还是暗含的)保证,包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改;这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和/或程序进行改进和/或更改,而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的,不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分,使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的:(i)允许在独立创建的程序和其他程序(包括本程序)之间进行信息交换,以及(ii)允许对已经交换的信息进行相互使用,请与下列地址联系:

IBM Corporation
U59/600
3600 Steeles Ave East,
Markham, ON; L3R 9Z7
Canada

只要遵守适当的条件和条款,包括某些情形下的一定数量的付费,都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际程序许可证协议或任何同等协议中的条款提供。

此处包含的任何性能数据都是在受控环境中测得的。因此,在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的,因此不保证与一般可用系统上进行的测量结果相同。此外,有些测量是通过推算而估计的,实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试,也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

版权许可:

本信息包括源语言形式的样本应用程序,这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口(API)进行应用程序的开发、使用、经销或分发为目的,您可以任何形式对这些样本程序进行复制、修改、分发,而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此,IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。

凡这些实例程序的每份拷贝或其任何部分或任何衍生产品,都必须包括如下版权声明:

(C)(贵公司的名称)(年)。此部分代码是根据 IBM 公司的样本程序衍生出来的。(C) Copyright IBM Corp. 2006. All rights reserved.

如果您正以软拷贝格式查看本信息,图片和彩色图例可能无法显示。

编程接口

编程接口信息旨在帮助您创建使用此程序的应用软件。

通用编程接口允许您编写获取此程序的工具服务的应用软件。

但是,此信息也可能包含诊断、修改和调整信息。这些诊断、修改和调整信息用于帮助您调试应用软件。

警告:不要将此诊断、修改和调整信息用作编程接口,因为它是会更改的。

商标和服务标记

以下各项是 IBM Corporation 在美国和/或其他国家或地区的商标:

Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其他国家或地区的商标。

Microsoft、Windows、Windows NT 和 Windows 徽标是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

Intel、Intel Xeon 和 Pentium 是 Intel Corporation 或其分支机构在美国和其他国家或地区的商标或注册商标。

UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。

Linux 是 Linus Torvalds 在美国和/或其他国家或地区的注册商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。


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