Log and Trace Analyzer 的发行说明

© Copyright International Business Machines Corporation 2000, 2007. 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.2 导入远程日志文件时的问题
   1.3 在 Linux 和 AIX 上导入日志文件
   1.4 导入 WebSphere Application Server trace.log
   1.5 “内存不足”异常
   1.6 DB2 Express 诊断日志显示的日志事件不符合规范
   1.7 未对导入的日志文件类型执行任何验证
   1.8 导入其他语言环境中生成的日志文件时的局限
   1.9 从 AIX 导入带有规则解析器的 WebSphere Application Server 活动日志失败
   1.10 日志文件导入不支持过滤公共基本事件的复杂类型
   1.11 同时导入多个日志文件时的问题
   1.12 不支持使用同一数据库帐户同时进行客户机访问
   1.13 资源路径冲突
   1.14 无论是否选择了有效项,“大型资源支持”首选项都保持禁用状态
   1.15 提高大型日志支持的性能
   1.16 间歇出现 SQL 异常
   1.17 如果未应用首选项,则测试连接返回错误
   1.18 分析大型日志时不支持 XPath 表达式
   1.19 大型日志只显示一个 contextDataElement
   1.20 “新建日志关联”向导在 Linux GTK 驱动程序上显示不正确
   1.21 在带有 IBM JVM 的 Red Hat Linux V8.0 上创建示例时发生崩溃
   1.22 从“日志导航器”工具栏和弹出菜单只能创建 TPTP 格式症状数据库
   1.23 不处理长度超过 1024 字节的消息
   1.24 症状编辑器生成 XPATH 规则,而使用复杂元素时这些规则无效
   1.25 “时序图”视图不支持“代理程序和进程交互”视图
   1.26 “概要分析导航器”的刷新视图命令对于跟踪交互无效

1.0 已知局限、问题和变通方法

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

在“日志”视图中,“过滤和突出显示”功能在日志事件的复杂元素(例如,sourceComponentId)上不工作

1.2 导入远程日志文件时的问题

导入远程日志文件(文件 > 导入 > 概要分析和日志记录 > 日志文件)时,刷新概要分析监视器的视图(概要文件 > 刷新视图)后“日志”视图中不显示任何日志条目,或等待 30 秒钟后显示一个“日志记录消息”对话框,指出本地客户机尚未开始监视远程日志解析器。
此问题是由于网络等待时间而引起的,可通过增大 Agent Controller 等待本地客户机开始监视远程日志解析器的时间来更正。作为此问题的变通方法,请尝试以下步骤:


尝试重新导入日志文件。

如果症状仍然存在,请在 Agent Controller 配置(即 <Agent Controller 安装目录>/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)。
执行更新之后,请重新启动 Agent Controller,并尝试重新导入日志文件。

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

在 Linux® 和 AIX® 平台上根本无法导入某些日志文件。

当用户没有正确的许可权访问日志文件时会发生此情况。为解决此问题,应将日志文件复制到用户主目录中并从用户主目录导入日志文件。

1.4 导入 WebSphere Application Server trace.log

导入 WebSphere® Application Server trace.log 文件时会创建内部关联。

用户不应删除这些关联,因为它们包含与相应代理程序的内部结构相关的信息。

1.5 “内存不足”异常

最多可将 25MB 日志文件导入到工作空间中。打开日志文件的时间取决于文件中的日志记录数,并且可能会遇到“内存不足”异常。

作为此问题的变通方法,请使用“大型日志支持”功能。

1.6 DB2 Express 诊断日志显示的日志事件不符合规范

如果导入 IBM DB2® Express 诊断日志,则显示的已生成的日志事件并不会完全遵循日志事件规范。这是由于 db2diag.exe 实用程序中的一个错误而引起的,该实用程序用于将 DB2 诊断日志转换为日志事件。它应当不会对导入操作有任何影响。除非修复 db2diag.exe,否则没有其他已知变通方法。 

1.7 未对导入的日志文件类型执行任何验证

未对导入的日志文件类型执行任何验证。导入日志文件时,请确保为将导入的日志文件选择了正确的日志类型和版本。如果导入期间发生问题,则“日志”视图中将不会显示任何记录,或将会显示错误记录,并且将显示错误消息。有关此错误的更多详细信息,请查看错误对话框中的详细信息。 

1.8 导入其他语言环境中生成的日志文件时的局限

导入日志文件时,如果它们包含的时间戳记所在的语言环境与工作台执行的语言环境不同,则基于规则的日志文件解析器有时不能正确地对时间戳记和其他日志记录数据进行解析。例如,要将英语 IBM HTTP Server 访问日志文件导入到日语机器,生成的日志事件中的 creationTime 值将具有零值,并且日志事件消息字段将为空白。

作为此问题的变通方法,导入日志文件时,如果它们包含的时间戳记所在的语言环境与当前机器语言环境不同,并且如果存在语言环境字段,请在“日志导入”向导的“详细信息”选项卡中指定日志文件的语言环境。

1.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.10 日志文件导入不支持过滤公共基本事件的复杂类型

指定要导入的日志文件时,可创建高级过滤器。在添加过滤器属性对话框中,属性字段有一个组合框。该组合框列出一些日志事件属性。请注意它并不列出日志事件属性的复杂类型。 

1.11 同时导入多个日志文件时的问题

同时导入多个日志文件时,已导入记录的日期可能不正确。作为此问题的变通方法,请一次只导入一个文件。 

1.12 不支持使用同一数据库帐户同时进行客户机访问

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

1.13 资源路径冲突

如果将相同的数据库和数据库帐户用于多个工作空间,则可能导致资源路径冲突并且资源将不会持久保存到数据库中。

作为此问题的变通方法,请在每个工作空间中使用不同的项目和监视器名称,以避免资源路径冲突。

1.14 无论是否选择了有效项,“大型资源支持”首选项都保持禁用状态

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

作为此问题的变通方法,请选择 DB2 作为数据库类型,并应用这些设置。关闭并重新打开“首选项”对话框;字段将被启用。

1.15 提高大型日志支持的性能

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

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

1.16 间歇出现 SQL 异常

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

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

发生此问题时,如果以网络方式使用 DB2 或 Cloudscape™,请重新启动工作台和数据库。在发生此异常时导入的日志不会是有效的,并且必须重新导入。

1.17 如果未应用首选项,则测试连接返回错误

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

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

分析大型日志时,不支持以下 XPath 表达式。
    <expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.19 大型日志只显示一个 contextDataElement

如果 DB2 用于大型日志支持,则日志视图中只显示事件的一个 contextDataElement,即使该事件具有多个 contextDataElement 也如此。

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

在“新建日志关联”向导中,只显示“可用日志”列表,并且该列表为空。此情况是由于只显示向导页面的左侧部分而引起的。

作为此问题的变通方法,请尝试调整向导页面大小,以显示“选定日志”列表和操作按钮。还有一种变通方法是在单击“新建日志关联”按钮之前在“日志导航器”视图中选择关联的日志文件。

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

使用“示例创建”向导创建示例(新建 > 示例)时,工作台崩溃。当“示例创建”向导尝试作为创建步骤的一部分打开 readme.html 文件时会发生此问题。此问题是在带有 IBM Java™ 虚拟机(JVM)的 Red Hat Linux V8.0 上发现的,它是一个 SWT 错误(https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515)。

作为此问题的变通方法,请尝试将 -Xj9 作为 JVM 参数添加到 ac.sh 中,以使用 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 系统:GTK+ 窗口小部件工具包 V2.2.1 和关联库(GLib 和 Pango);SWT HTML 查看器需要 Mozilla 1.4GTK2。对于其他 Linux 系统上的 Motif:Open Motif 2.1(已包含);SWT HTML 查看器需要 Mozilla 1.4GTK2。

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

由于 TPTP 限制,用户无法从日志导航器工具栏按钮和上下文菜单同时创建两种症状数据库。变通方法是从工作台菜单选择文件 > 新建 > 其他 > 概要分析和日志记录,然后选择希望创建的症状数据库的类型。 

1.23 不处理长度超过 1024 字节的消息

在 XPath 规则和 IBM 相关规则中,消息日志事件属性中的字符串长度不应超过 1024 字节。如果字符串超过 1024 字节,则不会被处理。

1.24 症状编辑器生成 XPATH 规则,而使用复杂元素时这些规则无效

使用日志事件的复杂元素(例如,sourceComponentID)时,症状编辑器将生成无效的 XPATH 规则。 

1.25 “时序图”视图不支持“代理程序和进程交互”视图

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

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

1.26 “概要分析导航器”的刷新视图命令对于跟踪交互无效

“概要分析导航器”的刷新视图命令对于跟踪交互无效。但是,跟踪交互会以固定的时间间隔自动刷新。

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