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 代理控制器 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 在安装了 Sun JDK 1.4.x 的 Windows 上进行概要分析可能会产生 Microsoft® 错误报告
TPTP V3.3 发行说明中提供了与 TPTP 日志和跟踪分析器相关联的更多自述文件信息。
当导入远程日志文件(文件 > 导入... > 日志文件)时,在刷新概要分析监视器的视图(概要分析 > 刷新视图)后日志视图中未显示任何日志条目,或者显示“记录消息”对话框以指出本地客户机在等待 30 秒后未开始监视远程日志解析器。
这一问题是网络延迟造成的,可通过增加代理控制器等待本地客户机开始监视远程日志解析器的时间来修正它。要解决此问题,尝试执行下列步骤:
<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)。
某些日志文件导入操作在 Linux 和 AIX® 平台上根本不起作用。
如果用户没有用于访问日志文件的适当许可权,就会发生这种情况。要解决此问题,应将日志文件复制到用户的主目录中并从该主目录导入它们。
1.2.3 导入 WebSphere Application Server trace.log导入 WebSphere Application Server trace.log 文件时将创建内部关联。
由于这些关联包含有关对应代理程序内部结构的信息,因此用户不应删除它们。
1.2.4 某些日志文件不能使用 IBM 代理控制器 V5 导入activity.log 之外的远程日志文件不能使用 IBM 代理控制器 V5 导入。远程导入日志文件时,远程机器上代理控制器的级别必须等于或高于“日志和跟踪分析器”的级别才能进行自主计算。
为解除这一局限性,在远程机器上安装“日志和跟踪分析器”附带的 IBM 代理控制器。
1.2.5 内存不足异常最多可将 25MB 的日志文件导入到工作空间并在“日志和跟踪分析器”中打开它们。打开日志文件所需的时间取决于文件中的日志记录数,并且可能出现“内存不足”异常。
要解决此问题,应使用大型日志支持功能部件。
1.2.6 在 Linux GTK 驱动程序上的导入日志文件向导中添加日志文件时发生索引值超出限制错误在导入日志文件时,如果试图在“添加日志文件”向导中单击确定,则将导致索引值超出限制错误。这是因为要添加的日志文件还未选择版本。
确保已在“添加日志文件”向导“详细信息”选项卡的版本下拉列表中选择了有效的版本选项。
如果您导入 DB2 诊断日志,则“日志和跟踪分析器”中生成的“公共基本事件”将违反某些“公共基本事件”规范。这是由于 db2diag.exe 实用程序中存在的错误造成的,该实用程序用来将 DB2 诊断日志转换为“公共基本事件”。这不会影响操作。在修正 db2diag.exe 之前,没有已知的变通方法。
“日志和跟踪分析器”不会对要导入的日志文件类型进行任何验证。当导入日志文件时,确保对要导入的日志文件选择了正确的日志类型和版本。如果导入期间发生了问题,则日志视图中没有记录,或显示不正确的记录,并且将显示一条错误消息。有关该错误的更详细的信息,请从错误对话框中查看详细信息,或者,查看 .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log 文件(如果该文件存在于 workspace 目录中的话)。此文件可能包含有关在解析日志文件时发生的错误的信息。
如果导入日志文件时发生错误,则会显示一条错误消息,但是日志视图中不会显示任何记录,或者日志视图的记录中会显示不正确的数据。
从非英语机器中或在非英语机器上导入 WebSphere Application Server 活动日志文件时,基于规则的日志文件解析器不能成功地将日志记录数据映射至公共基本事件。而是,某些日志记录数据可能会出现在公共基本事件的不正确字段中。
要解决此问题,从非英语机器中或在非英语机器上导入 WebSphere Application Server 活动日志文件时,应使用静态日志文件解析器。
当导入包含时间戳记的日志文件(该时间戳记所处的语言环境不同于“日志和跟踪分析器”执行所处的语言环境)时,基于规则的日志文件解析器有时不能正确解析时间戳记和其它日志记录数据。例如,如果将英语 IBM HTTP Server 访问日志文件导入到正在日语机器上运行的“日志和跟踪分析器”中,生成的公共基本事件中的 creationTime 值将为零并且公共基本事件消息字段将为空白。
要解决此问题,当导入包含时间戳记的日志文件(该时间戳记所处的语言环境不同于当前机器的语言环境)时,应使用静态日志文件解析器(如果有)。
如果“日志和跟踪分析器”未正确安装并且缺少某些文件,则导入日志文件可能会失败并显示以下记录消息:
java.lang.reflect.InvocationTargetException
要解决此问题,请重新安装“日志和跟踪分析器”。注意:在 Windows XP 上进行安装时,不要使用 Windows XP 本机解压缩实用程序。有关更多详细信息,请参阅下面的使用 Windows XP 解压缩实用程序进行解压缩时出现问题这一节。
当导入空日志或者使用将过滤掉所有日志事件的导入过滤器时,日志视图将显示为空白,并且可能会抛出 NullPointerException(在 XMLLoader.endElement 中)。检查日志文件,或者尝试使用另一个允许装入某些事件的过滤器。
无
在“新建日志关联”向导中,仅显示“可用的日志”列表,并且该列表是空的。这是因为只显示了向导页的左边部分。
要解决此问题,尝试调整向导页的大小以便显示“选择的日志”列表和操作按钮。另一个变通方法是在“日志导航器”视图中选择要关联的日志文件,然后单击“新建日志关联”按钮。
如果在第一次启动工作台后在插件的 plugin.xml 文件中修改了它的记录级别(通过 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 扩展点),在以后启动工作台时不会接受这一更改。在插件的 plugin.xml 文件中指定的记录级别由 Eclipse 运行时在第一次启动工作台时高速缓存。不管在 plugin.xml 文件中作何修改,以后启动工作台时会使用插件记录级别的高速缓存值。
要解决此问题,应使用 -clean 命令行参数重新启动工作台。此选项将清除用来存储 bundle 依赖性解决方案和 Eclipse 扩展注册表数据的高速缓存,并且将强制 Eclipse 重新初始化这些高速缓存。在 <workbench installation directory>\eclipse\ac.bat(Windows)或 <workbench installation directory>/eclipse/ac.sh(Linux)中的 eclipse.exe 之后添加该选项。或者,可在“记录首选项”页面(窗口 > 首选项 > 记录)上修改插件的记录级别然后重新启动工作台。
在 Windows XP 上安装“日志和跟踪分析器”时,使用 Windows XP 本机解压缩实用程序来解压缩“日志和跟踪分析器”运行时文件时出现问题。某些目录和文件不会解压缩。这一问题将导致无法使用“日志和跟踪分析器”来导入某些日志文件类型。
为解决此问题,在 Windows XP 上进行安装时使用另一解压缩实用程序,如 WinZip 或 UnZip。
使用“创建示例”向导(新建 > 示例)在“日志和跟踪分析器”中创建示例时,工作台崩溃了。当“创建示例”向导尝试打开 readme.html 文件(作为创建步骤的一部分)时,会发生这种情况。在带有 IBM 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。
使用由记录工具提供的日志视图,最适合查看由工作台生成的 CommonBaseEvents.log 文件。或者,可以使用支持 XML 的浏览器来查看 XML 文档格式的日志文件(即,安装目录的 workspace\.metadata 子目录中名为 CommonBaseEvents.log_Viewer.xml 的文件)。只能使用 Microsoft Internet Explorer V6.0.28 和更高版本来查看此文件。
由于 TPTP 存在局限性,用户不能从日志导航器工具栏按钮和上下文菜单创建两种类型的症状数据库。变通方法是从工作台菜单中选择文件 > 新建 > 其它 > 概要分析和记录,然后选择您想要创建的症状数据库的类型。
代理程序交互视图和进程交互视图在日志文件的“时序图”视图不受支持。
这一问题目前没有变通方法。
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 构建遇到了该问题。
©Copyright IBM Corporation 2000, 2005. All Rights Reserved.