日志和跟踪分析器 V6.0.1 - 自述文件

已知问题和变通方法

1.0 日志和跟踪分析器
1.1 视图
1.2 导入日志
1.2.1 导入远程日志文件时的问题
1.2.2 在 Linux 和 AIX 上导入日志文件
1.2.3 导入 WebSphere Application Server trace.log
1.2.4 使用 IBM Agent Controller V5 无法导入某些日志文件
1.2.5 “内存不足”异常
1.2.6 在 Linux GTK 驱动程序上的“导入日志文件”向导中添加日志文件时,发生“索引值超出限制”错误
1.2.7 DB2 诊断日志显示的公共基本事件不符合规范
1.2.8 不显示导入日志文件时的错误
1.2.9 导入 WebSphere activity.log 文件的限制
1.2.10 导入不同语言环境中生成的日志文件的限制
1.2.11 导入失败并带有 InvocationTargetException 消息
1.2.12 导入空日志时,发生 NullPointerException
1.3 数据库支持
1.4 其他
1.4.1 “新建日志关联”向导在 Linux GTK 驱动程序上显示不正确
1.4.2 在首次启动工作台之后,对插件日志记录级别的修改无效
1.4.3 使用 Windows XP 解压缩实用程序进行解压缩的问题
1.4.4 使用 IBM JVM 在 Red Hat Linux v8.0 上创建示例时崩溃
1.4.5 查看日志记录实用程序 XML 日志文件的浏览器限制
1.4.6 从“日志导航器”工具栏和弹出菜单只能创建 TPTP 格式症状数据库
2.0 概要分析工具
2.1 “时序图”视图不支持“代理程序和进程交互”视图
2.2 “概要分析导航器”的刷新视图命令对于跟踪交互无效
2.3 在 Windows 上使用 Sun JDK 1.4.x 进行概要分析在结束时带有 Microsoft 错误报告

与 TPTP 日志和跟踪分析器关联的其他自述信息可在 TPTP V3.3 发行说明中获取。


1.0 日志和跟踪分析器

1.1 视图

不适用

1.2 导入日志

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

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

此问题是由于网络等待时间而引起的,可通过增大 Agent Controller 等待本地客户机开始监视远程日志解析器的时间来修复此问题。为解决此问题,请尝试以下步骤:

  1. 尝试重新导入日志文件。
  2. 如果症状仍然存在,请在 Agent Controller 配置中向远程 RemoteLogParserLoader 应用程序添加以下条目(即 <Agent Controller 安装目录>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml):
      
    <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. 在执行更新之后,请重新启动 Agent Controller,并尝试重新导入日志文件。

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

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

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

1.2.3 导入 WebSphere Application Server trace.log

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

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

1.2.4 使用 IBM Agent Controller V5 无法导入某些日志文件

使用 V5 IBM Agent Controller 无法导入除 activity.log 之外的远程日志文件。远程导入日志文件时,远程机器上的 Agent Controller 必须与自主计算日志和跟踪分析器位于相同级别,或位于比自主计算日志和跟踪分析器更高的级别。

为解决此限制,请在远程机器上安装日志和跟踪分析器附带的 IBM Agent Controller。

1.2.5 “内存不足”异常

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

为解决此问题,请使用大日志支持功能。

1.2.6 在 Linux GTK 驱动程序上的“导入日志文件”向导中添加日志文件时,发生“索引值超出限制”错误

导入日志文件期间,尝试在“添加日志文件”向导中单击确定时发生索引值超出限制错误。此情况是由于将添加的日志文件没有选择版本而引起的。

请确保在“添加日志文件”向导“详细信息”选项卡下的版本下拉列表中选择了有效的版本选项。

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

如果导入 DB2 诊断日志,则日志和跟踪分析器中显示的所生成的公共基本事件违反某些公共基本事件规范。这是由于 db2diag.exe 实用程序中的一个错误而引起的,该实用程序用于将 DB2 诊断日志转换为公共基本事件。此错误不应当会影响操作。除非修复 db2diag.exe,否则没有其他已知变通方法。

1.2.8 日志和跟踪分析器不对导入的日志文件类型执行任何验证

日志和跟踪分析器不对导入的日志文件类型执行任何验证。导入日志文件时,请确保为将导入的日志文件选择了正确的日志类型和版本。如果导入期间发生问题,则“日志”视图中将不会显示任何记录,或将会显示错误记录,并且将显示错误消息。有关此错误的更多详细信息,请查看错误对话框中的详细信息,或在 workspace 目录中存在文件 .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log 的情况下,尝试查看该文件。此文件可能包含有关对日志文件进行语法分析期间所发生的错误的信息。

如果导入日志文件时发生错误,则将显示错误消息,并且在“日志”视图中不会显示任何记录,或在“日志”视图的记录中显示错误数据。

1.2.9 导入 WebSphere Application Server activity.log 文件的限制

从非英语机器或在该机器上导入 WebSphere Application Server 活动日志文件时,基于规则的日志文件解析器不能成功地将日志记录数据映射到公共基本事件。一些日志记录数据而是可能显示在公共基本事件的错误字段中。

为解决此问题,当从非英语机器或在该机器上导入 WebSphere Application Server 活动日志文件时,请使用静态日志文件解析器。

1.2.10 导入不同语言环境中生成的日志文件的限制

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

为解决此问题,在导入日志文件时,如果它们包含的时间戳记所在的语言环境与当前机器语言环境不同,则在有静态日志文件解析器的情况下,使用静态日志文件解析器。

1.2.11 导入失败并带有 InvocationTargetException 消息

如果未正确安装日志和跟踪分析器并且日志和跟踪分析器缺少某些文件,则导入日志文件可能会失败,并带有以下日志记录消息:

java.lang.reflect.InvocationTargetException

为解决此问题,请重新安装日志和跟踪分析器。 注:在 Windows XP 上安装时,不要使用本机 Windows XP 解压缩实用程序。请参阅以下的使用 Windows XP 解压缩实用程序进行解压缩的问题,获取更多详细信息。

1.2.12 导入空日志时,发生 NullPointerException

导入空日志或使用某个过滤掉所有日志事件的导入过滤器时,“日志”视图将显示为空,并且可能抛出 NullPointerException(在 XMLLoader.endElement 中)。请检查日志文件或尝试使用允许装入某些事件的其他过滤器。

1.3 数据库支持

不适用

1.4 其他

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

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

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

1.4.2 在首次启动工作台之后,对插件日志记录级别的修改无效

如果在首次启动工作台之后在 plugin.xml 文件中(通过 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 扩展点)修改插件的日志记录级别,则以后启动工作台时,更改将无效。首次启动工作台时,Eclipse 运行时将高速缓存插件 plugin.xml 文件中指定的日志记录级别。工作台以后启动时将使用插件日志记录级别的高速缓存值,而无论 plugin.xml 文件中有何修改。

为解决此问题,请使用 -clean 命令行参数重新启动工作台。此选项将清除用于存储捆绑依赖关系解析和 eclipse 扩展注册表数据的高速缓存,并强制 Eclipse 重新初始化这些高速缓存。在 <工作台安装目录>\eclipse\ac.bat(Windows)或 <工作台安装目录>/eclipse/ac.sh(Linux)中的 eclipse.exe 之后添加此选项。或者,您可以在日志记录首选项页面(窗口 > 首选项 > 日志记录)上修改插件日志记录级别,然后重新启动工作台。

1.4.3 使用 Windows XP 解压缩实用程序进行解压缩的问题

在 Windows XP 上安装日志和跟踪分析器时,使用 Windows XP 本机解压缩实用程序解压缩日志和跟踪分析器运行时文件会发生问题。一些目录和文件将不会被解压缩。此问题会导致无法使用日志和跟踪分析器导入某些日志文件类型。

为解决此问题,在 Windows XP 上安装时,请使用其他解压缩实用程序(例如 WinZip 或 UnZip)。

1.4.4 使用 IBM JVM 在 Red Hat Linux v8.0 上创建示例时崩溃

使用“示例创建”向导在日志和跟踪分析器中创建示例(新建 > 示例)时,工作台崩溃。当“示例创建”向导尝试作为创建步骤的一部分打开 readme.html 文件时会发生此问题。在带有 IBM 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.4.5 查看公共日志记录 XML 日志文件的浏览器限制

最好使用日志记录工具提供的日志视图查看工作台生成的 CommonBaseEvents.log 文件。或者,您可以使用支持 XML 的浏览器查看 XML 文档格式的日志文件(即安装目录的子目录 workspace\.metadata 中名为 CommonBaseEvents.log_Viewer.xml 的文件)。只能使用 Microsoft Internet Explorer V6.0.28 和以上版本查看此文件。

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

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

2.0 概要分析工具

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

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

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

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

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

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

2.3 在 Windows 上使用 Sun JDK 1.4.x 进行概要分析在结束时带有 Microsoft 错误报告

Bugzilla 缺陷:103058

概要分析或应用程序终止,同时显示消息“java.exe 遇到问题,需要关闭。对此造成的不便,我们非常抱歉。”该消息包含向 Microsoft 提交错误报告的信息和选择。请参阅 bugzilla 103058,获取消息的屏幕捕获图。

在多种方式中都观测到了此问题:时间分析(带有或不带有“显示实例”)、内存分析和这些方式的组合。可通过在关闭 JIT 的情况下重新运行概要分析或应用程序来解决此问题,即通过作为 JVM 参数提供“-Djava.compiler=NONE”。SUN JDK 1.4.2_08-b03 build for Windows 遇到过此问题。


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

返回到主自述文件

版权和声明