Eclipse 自主日志和跟踪分析器发行说明

© 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 视图
1.1.1 日志视图中过滤和突出显示功能的问题
1.2 导入日志
1.2.1 导入远程日志文件时出现问题
1.2.2 在 Linux 和 AIX 上导入日志文件
1.2.3 导入 WebSphere Application Server trace.log
1.2.4 某些日志文件不能使用 IBM 代理控制器 V5 导入
1.2.5 导入大型日志文件和症状目录时发生内存不足异常
1.2.6 为 DB2 Express 诊断日志显示的公共基本事件不符合规范
1.2.7 日志和跟踪分析器不对所导入日志文件类型进行任何验证
1.2.8 导入不同语言环境中生成的日志文件时的局限性
1.2.9 使用规则解析器从 AIX 导入 WebSphere Application Server 活动日志时失败
1.2.10 不能使用 Apache Derby V10.1.2.1 创建基于时间的关联
1.2.11 创建和显示大型日志关联时性能可能会受到影响
1.3 数据库支持
1.3.1 不支持使用同一个数据库帐户同时从多个客户机进行访问
1.3.2 资源路径冲突
1.3.3 尽管所选项有效,但大型资源支持首选项仍保持禁用
1.3.4 改进大型日志支持的性能
1.3.5 创建数据库和表后重新启动 DB2
1.3.6 间断性的 SQL 异常
1.3.7 尚未应用首选项时测试连接会返回错误
1.3.8 分析大型日志时不支持 CommonBaseEvent XPath 表达式
1.3.9 仅对大型日志显示一个 contextDataElement
1.4 其他
1.4.1 在 Linux GTK 驱动程序上,未正确显示“新建日志关联”向导
1.4.2 第一次启动工作台后对插件记录级别的修改不被接受
1.4.3 在带有 IBM JVM 的 Red Hat Linux V8.0 上创建示例时崩溃
1.4.4 从日志导航器工具栏和弹出菜单只能创建 TPTP 格式的症状数据库
1.4.5 IBM 日志分析器最多只能处理 1024 字节的消息
1.4.6 在使用复杂元素时,症状编辑器生成了无效的 XPATH 规则
1.4.7 症状编辑器生成的 XPATH 规则与任何输入公共基本事件都不匹配
2.0 概要分析工具
2.1 代理程序和过程交互视图在“时序图”视图中不受支持
2.2 概要分析导航器的刷新视图命令对跟踪交互不起作用
2.3 在安装了 Sun JDK 1.4.x 的 Windows 上进行概要分析会产生 Microsoft(R) 错误报告

TPTP V4.2 发行说明中提供了与 TPTP 日志和跟踪分析器相关的更多自述文件信息。

1.0 日志和跟踪分析器

1.1 视图

1.1.1 日志视图中过滤和突出显示功能的问题

在“日志”视图中,“过滤”和“突出显示”功能不能处理公共基本事件的复杂元素(例如,sourceComponentId)。将在下一个修订包中提供修订。

1.2 导入日志

1.2.1 导入远程日志文件时出现问题

当导入远程日志文件(文件 > 导入... > 日志文件)时,在刷新概要分析监视器的视图(概要分析 > 刷新视图)之后日志视图中未显示任何日志条目,或者显示“记录消息”对话框以指出本地客户机在等待 30 秒后未开始监视远程日志解析器。

此问题是由于网络等待时间而造成的,可以通过增加代理控制器等待本地客户机开始监视远程日志解析器的时间来修正。要解决此问题,请尝试执行下列步骤:

  1. 再次尝试导入该日志文件。
  2. 如果症状仍然出现,则在代理控制器配置(即,<Agent Controller's installation directory>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml)中对远程 RemoteLogParserLoader 应用程序添加以下条目:
      
    <Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    ...
    <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/>
    ...
    </Application>
    
    其中 xxxxx 是以毫秒为单位的最大等待时间(即,大于 30000)。
  3. 完成更新后,请重新启动代理控制器并再次尝试导入该日志文件。

1.2.2 在 Linux 和 AIX 上导入日志文件

某些日志文件导入操作在 Linux(R) 和 AIX(R) 平台上根本不起作用。

如果用户没有用于访问日志文件的适当许可权,就会发生这种情况。要解决此问题,应该将日志文件复制到用户的主目录中并从该主目录导入这些日志文件。

1.2.3 导入 WebSphere Application Server trace.log

导入 WebSphere(R) Application Server trace.log 文件时将创建内部关联。

由于这些关联包含与对应代理程序的内部结构相关的信息,因此用户不应该将其删除。

1.2.4 某些日志文件不能使用 IBM 代理控制器 V5 导入

activity.log 之外的远程日志文件不能使用 IBM(R) 代理控制器 V5 导入。远程导入日志文件时,远程机器上的 IBM 代理控制器的级别必须等于或高于 IBM Eclipse 日志和跟踪分析器的级别。

要解除此局限性,请在远程机器上安装 IBM Eclipse 日志和跟踪分析器随附的 IBM 代理控制器。

1.2.5 导入大型日志文件和症状目录时发生内存不足异常

最多只能将 25MB 的日志文件和症状目录导入到工作空间并在日志和跟踪分析器中打开。

打开日志文件所花的时间取决于文件中的日志记录数目,并且可能抛出“内存不足”异常。要解决此问题,请使用大型日志支持功能部件。

如果在导入大型症状目录时抛出“内存不足”异常,则通过增加以下的 vmargs 来增加堆大小:

-vmargs -Xmx1000m

如果使用大型日志支持功能部件不能修正导入大型日志时出现的“内存不足”异常问题,则增加堆大小可能有所帮助。

1.2.6 为 DB2 Express 诊断日志显示的公共基本事件不符合规范

如果导入 IBM DB2(R) Express 诊断日志,则在日志和跟踪分析器中生成的公共基本事件将违反某些公共基本事件规范。这是由于用来将 DB2 诊断日志转换为公共基本事件的 db2diag.exe 实用程序中存在错误而引起的。然而这不会影响到导入操作。在修正 db2diag.exe 之前,没有已知的变通方法。

1.2.7 日志和跟踪分析器不对所导入日志文件类型进行任何验证

日志和跟踪分析器不对所导入日志文件类型进行任何验证。当导入日志文件时,确保对要导入的日志文件选择了正确的日志类型和版本。如果导入期间发生了问题,则日志视图中未显示记录或显示不正确的记录,并且将显示一条错误消息。有关该错误的更多详细信息,请从错误对话框查看。

1.2.8 导入不同语言环境中生成的日志文件时的局限性

当导入包含时间戳记的日志文件时,如果该日志文件所处的语言环境与执行日志和跟踪分析器的语言环境不同,则基于规则的日志文件解析器有时不能正确解析时间戳记和其他日志记录数据。例如,如果将英语版 IBM HTTP Server 访问日志文件导入到在日语版机器上运行的日志和跟踪分析器中,则生成的公共基本事件中的 creationTime 值将为零并且“公共基本事件消息”字段将为空白。

要解决此问题,在导入包含时间戳记的日志文件时,且该日志文件所处的语言环境与当前机器的语言环境不同,则如果存在“语言环境”字段,请在“导入日志”向导的“详细信息”选项卡上指定日志文件的语言环境。

1.2.9 使用规则解析器从 AIX 导入 WebSphere Application Server 活动日志时失败

使用规则解析器从 AIX 系统导入二进制 WAS 活动日志时失败,并在错误对话框中显示了下列错误:

IWAT0030E 执行远程日志解析器“com.ibm.etools.logging.adapter.config.StaticParserExtension”期间发生了错误:
IWAT0412E 解析日志文件 /home/tfoun/logs/activity.log 时发生了错误。
java.lang.Exception: IWAT0239E 转换器命令失败:java.lang.Exception:
IWAT0238E 转换器进程结束,退出值为 1

在 AIX 上,转换器命令在将二进制日志文件转换为文本以便可以对其进行解析时失败。要解决此问题,请使用静态解析器来导入二进制活动日志文件,或者使用 WAS showlog 实用程序将二进制活动日志文件转换为文本,然后将生成的文本文件导入到日志和跟踪分析器。可以在 WAS 安装目录的 bin 目录中找到 WAS showlog 实用程序。例如,使用以下命令将二进制日志文件转换为 activity.txt 文本文件:

/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt

然后将 activity.txt 导入到日志和跟踪分析器。

1.2.10 不能使用 Apache Derby V10.1.2.1 创建基于时间的关联

虽然 TPTP 未正式支持 Derby 10.1.2.1,但 TPTP 用户可以尝试将 Derby 10.1.2.1 用于大型日志支持并且会遇到此问题。当尝试与大型日志创建基于时间的关联时,将发生 ArrayIndexOutOfBoundsException,它会导致该关联持续运行而不停止。这是一个已知 Derby 错误,已在 Derby V10.2.0.0 中修正。有关更多信息,请参阅 Derby 错误的描述,网址为:http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html

注意,此异常在服务器端发生,因此在用户的工作台上看不到。它显示在发出了启动 Derby 服务器命令的命令窗口中。

1.2.11 创建和显示大型日志关联时性能可能会受到影响

创建或显示大型日志的关联时,Apache Derby 和 DB2 的性能可能会受到影响。

要在创建关联时改进性能,请使用导入过滤器来导入日志,以便将不必要或不相关的事件排除在数据库之外。在“日志交互”视图中打开关联时,使用“仅显示关联事件”过滤器可以改进性能。

1.3 数据库支持

1.3.1 不支持使用同一个数据库帐户同时从多个客户机进行访问

从客户机对数据库进行同时访问可能会锁定某些表。要将这些表解锁,请重新启动工作台和数据库服务器。

1.3.2 资源路径冲突

如果对多个工作空间使用同一数据库和数据库帐户,则可能会造成资源路径冲突,导致资源将不能持久保存至该数据库。

要解决此问题,请在每个工作空间中使用不同的项目和监视名称来避免资源路径冲突。

1.3.3 尽管所选项有效,但大型资源支持首选项仍保持禁用

在 Linux/GTK 中的“大型资源支持”首选项页上,即使选择了有效的数据库类型,数据库设置字段仍将保持禁用。

要解决此问题,请选择 DB2 作为数据库类型,然后应用这些设置。关闭并重新打开首选项对话框;这样就可以启用这些字段。

1.3.4 改进大型日志支持的性能

要改进大型日志支持的性能,请在导入大型日志后运行以下命令:

db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x
/scripts/runStatsForAllHyadesTablesDB2-8.1.sql
其中 x_x_x 是插件目录的版本号。

1.3.5 创建数据库和表后重新启动 DB2

运行数据库和表创建脚本 CreateDatabaseAndTablesDB2-8.1.sql 之后,必须重新启动 DB2。从 DB2 命令窗口中运行 db2stop,然后运行 db2start,以便应用该脚本对配置参数所做的更改。

1.3.6 间断性的 SQL 异常

有时可能会发生以下 SQL 异常:

com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031

发生此问题时,如果通过网络方式使用 DB2 或 CloudscapeTM,则重新启动工作台和数据库。发生此异常时已导入的日志将无效,必须重新导入。

1.3.7 尚未应用首选项时测试连接会返回错误

在“首选项”对话框的“概要分析和记录”部分的“大型日志支持”页中,如果在应用对设置的更改之前单击测试连接,则可能会遇到连接错误。要避免此错误,请在做出任何设置更改之后单击应用,然后单击测试连接

1.3.8 分析大型日志时不支持 CommonBaseEvent XPath 表达式

IBM 日志分析器在分析大型日志时不支持以下 XPath 表达式。

	<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.3.9 仅对大型日志显示一个 contextDataElement

如果对大型日志支持使用 DB2,则即使事件具有多个 contextDataElement,在“日志”视图中仍仅显示该事件的一个 contextDataElement。

1.4 其他

1.4.1 在 Linux GTK 驱动程序上,未正确显示“新建日志关联”向导

在“新建日志关联”向导中,仅显示“可用的日志”列表,并且该列表是空的。这是因为仅显示了向导页的左边部分。

要解决此问题,请尝试调整向导页的大小以便显示“所选日志”列表和操作按钮。另一个变通方法是在“日志导航器”视图中选择要关联的日志文件,然后单击“新建日志关联”按钮。

1.4.2 第一次启动工作台后对插件记录级别的修改不被接受

第一次启动工作台后,如果在某个插件的 plugin.xml 文件中通过 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 扩展点修改了该插件的记录级别,则在以后启动工作台时不会接受这一更改。在插件的 plugin.xml 文件中指定的记录级别由 Eclipse 运行时在第一次启动工作台时高速缓存。不管在 plugin.xml 文件中进行怎样的修改,以后启动工作台时将使用高速缓存的插件记录级别的值。

要解决此问题,请使用 -clean 命令行参数重新启动工作台。此选项将清除用来存储束依赖性解决方案和 Eclipse 扩展注册表数据的高速缓存,并且将强制 Eclipse 重新初始化这些高速缓存。在 <workbench installation directory>\eclipse\ac.bat(Windows(R))或 <workbench installation directory>/eclipse/ac.sh(Linux)中的 eclipse.exe 之后添加该选项。此外,还可以在“记录”首选项页(窗口 > 首选项 > 记录)中修改插件的记录级别,然后重新启动工作台。

1.4.3 在带有 IBM JVM 的 Red Hat Linux V8.0 上创建示例时崩溃

使用“创建示例”向导(新建 > 示例)在日志和跟踪分析器中创建示例时,工作台会崩溃。在执行创建步骤的过程中,当“创建示例”向导尝试打开 readme.html 文件时,会发生这种情况。在带有 IBM JavaTM 虚拟机(JVM)的 Red Hat Linux v8.0 上会出现此问题,并且是一个 SWT 错误(https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515)。

要解决此问题,请尝试在 ac.sh 中添加 -Xj9 作为 JVM 参数以便使用 IBM J9 JVM 来启动。(例如,./eclipse -vmargs -Xj9 -Xmx500m)。有关在 Red Hat Linux V8.0 上运行 SWT 的更多信息,请查阅 SWT FAQ(http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html)。

注意:Eclipse 参考平台表(http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments)中所述,仅支持下列 Linux 系统:版本 2.2.1 的 GTK+ 窗口小部件工具箱和相关的库(GLib 和 Pango);SWT HTML 查看器需要 Mozilla 1.4GTK2。对于其他 Linux 系统上的 Motif:Open Motif 2.1(已包括);SWT HTML 查看器需要 Mozilla 1.4GTK2。

1.4.4 从日志导航器工具栏和弹出菜单只能创建 TPTP 格式的症状数据库

由于 TPTP 存在局限性,用户不能从日志导航器工具栏按钮和上下文菜单创建两种类型的症状数据库。变通方法是从工作台菜单中选择文件 > 新建 > 其他 > 概要分析和记录,然后选择您想要创建的症状数据库的类型。

1.4.5 IBM 日志分析器最多只能处理 1024 字节的消息

在 XPATH 规则和 IBM 关联规则中,msg 公共基本事件属性中的字符串不应该超过 1024 字节。如果字符串超过 1024 字节,则 IBM 日志分析器无法对其进行处理。

1.4.6 在使用复杂元素时,症状编辑器生成了无效的 XPATH 规则

使用公共基本事件的复杂元素(例如,sourceComponentID)时,症状编辑器将生成无效的 XPATH 规则。将在下一个修订包中提供修订。

1.4.7 症状编辑器生成的 XPATH 规则与任何输入公共基本事件都不匹配

如果在创建新的 XPATH 表达式时选择了任何 ExtendedDataElement,则生成的症状目录将包含 extendedDataElement,而不是 extendedDataElements。结果,症状编辑器生成的 XPATH 规则与任何输入公共基本事件都不匹配。

2.0 概要分析工具

2.1 代理程序和过程交互视图在“时序图”视图中不受支持

代理程序交互视图和过程交互视图在日志文件的“时序图”视图不受支持。

此问题目前没有变通方法。

2.2 概要分析导航器的刷新视图命令对跟踪交互不起作用

概要分析导航器的刷新视图命令对跟踪交互不起作用。但是,跟踪交互定期会自动刷新。

变通方法是在概要分析树中选择另一节点,然后再次选择先前的节点。

2.3 在安装了 Sun JDK 1.4.x 的 Windows 上进行概要分析可能会产生 Microsoft 错误报告

Bugzilla 缺陷:103058

概要分析或应用程序终止时产生消息:“java.exe 遇到了问题并需要关闭。请包涵由此带来的不便。”该消息包含信息以及是否将错误报告提交给 Microsoft 的选项。有关该消息的屏幕捕获,请参阅 bugzilla 103058

已经在多种方式下遇到此问题:“时间分析”(带或者不带“显示实例”)、“内存分析”以及这两种方式的组合。可以通过在关闭 JIT 之后(即,将“-Djava.compiler=NONE”作为 JVM 参数)重新运行概要分析或应用程序来解决该问题。Windows 的 SUN JDK 1.4.2_08-b03 构建遇到了该问题。