1.0 日志和跟踪分析器
1.1 视图
1.1.1 “日志导航器”视图未正确刷新
1.1.2 高级过滤器未过滤没有匹配属性值的日志记录
1.1.3 “概要分析和记录”透视图可能缺少工具栏按钮和菜单项
1.2 导入日志
1.2.1 导入远程日志文件时出现问题
1.2.2 在 Linux 和 AIX 上导入日志文件
1.2.3 导入 WebSphere Application Server trace.log
1.2.4 导入和查看跟踪文件
1.2.5 代理控制器安全性功能部件在日志和跟踪分析器中不受支持
1.2.6 某些日志文件不能使用 IBM 代理控制器 V5 导入
1.2.7 内存不足异常
1.2.8 在 Linux GTK 驱动程序上的导入日志文件向导中添加日志文件时发生索引值超出限制错误
1.2.9 不能从 Linux GTK 驱动程序中的 .metadata 文件夹导入
LoggingUtil.log 文件
1.2.10 不能使用基于规则的解析器导入需要转换的日志文件
1.2.11 不支持使用静态解析器连续监视日志文件
1.2.12 未显示导入日志文件时发生的错误
1.2.13 导入 WebSphere Application Server activity.log 文件时的局限性
1.2.14 导入不同语言环境中生成的日志文件时的局限性
1.2.15 导入失败并显示 InvocationTargetException 消息
1.3 其它
1.3.1 新建日志关联向导在 Linux GTK 驱动程序上未正确显示
1.3.2 第一次启动工作台后对插件记录级别的修改不被接受
1.3.3 使用 Windows XP 解压缩实用程序进行解压缩时出现问题
1.3.4 在带有 IBM JVM 的 Red Hat Linux V8.0 上创建示例时崩溃
2.0 概要分析工具
2.1 代理程序和过程交互视图在“时序图”视图中不受支持
2.2 “时序图”视图显示的返回调用指向的位置不正确
2.3 概要分析导航器的刷新视图命令对跟踪交互不起作用
2.4 “在服务器上进行概要分析”概要分析选项对 J2FF 请求概要分析程序不适用
2.5 *“新建过滤器集合”在非英语工作台上创建英语过滤规则,并且英语过滤规则在保存时被视为
INCLUDE
在“资源导航器”视图中执行删除操作后,“日志导航器”视图未被刷新。
可通过右键单击“日志导航器”视图并在上下文菜单中选择“从本地刷新”来手工刷新。
1.1.2 高级过滤器未过滤没有匹配属性值的日志记录在日志视图中使用“高级过滤”时,对于在高级过滤器表中指定要进行比较的字段,没有匹配属性值的日志记录将不会被过滤掉。
目前没有变通方法。
1.1.3 “概要分析和记录”透视图可能缺少工具栏按钮和菜单项如果先前对 Java 应用程序或任何其它启动配置类型进行了概要分析,则可能在未完全激活“概要分析和记录”功能的情况下打开了“概要分析和记录”透视图。因此,当您返回至“概要分析和记录”透视图时,大多数工具栏按钮和菜单项都不会出现。
要显示缺少的工具栏按钮和菜单项:
为完全避免此问题,先启用“概要分析和记录”功能再进行概要分析。
导入远程日志文件(即“文件”>“导入...”>“日志文件”)时,在刷新概要分析监视器的视图(即“概要分析”>“刷新视图”)后日志视图中未显示任何日志条目,或者显示“记录消息”对话框以指示本地客户机在等待 30 秒后未开始监视远程日志解析器。
这一问题是网络延迟造成的,可通过增加代理控制器等待本地客户机开始监视远程日志解析器的时间来修正它。要解决此问题,尝试执行下列步骤:
<Application configuration="default" executable="RemoteLogParserLoader"其中 xxxxx 是以毫秒为单位的最长等待时间(即大于 30000)。
location="%JAVA_PATH%" path="%JAVA_PATH%\java.exe">
...
<Parameter position="prepend"
value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx">
</Parameter>
...
</Application>
某些日志文件导入操作在 Linux 和 AIX 平台上根本不起作用。
如果用户没有用于访问日志文件的适当许可权,就会发生这种情况。要解决此问题,应将日志文件复制到用户的主目录中并从该主目录导入它们。
1.2.3 导入 WebSphere Application Server trace.log导入 WebSphere Application Server trace.log 文件时将创建内部关联。
用户不应删除这些关联,因为它们包含有关对应代理程序的内部结构的信息。
1.2.4 导入和查看跟踪文件对于使用日志分析器跟踪输出格式生成的 WebSphere Application Server V5.0.1 或较低版本的跟踪文件,不能使用日志和跟踪分析器来进行导入和查看。
要解除这一局限性,在生成要使用日志和跟踪分析器导入和查看的跟踪文件之前,先将 WebSphere Application Server 跟踪输出格式设置为“基本”或“高级”。
1.2.5 代理控制器安全性功能部件在日志和跟踪分析器中不受支持如果安装了启用安全性的代理控制器,您将无法对应用程序进行概要分析或导入日志文件。
为解除这一局限性,重新安装禁用安全性的代理控制器。
1.2.6 某些日志文件不能使用 IBM 代理控制器 V5 导入activity.log 之外的远程日志文件不能使用 IBM 代理控制器 V5 导入。远程导入日志文件时,远程机器上的代理控制器的级别必须等于或高于日志和跟踪分析器的级别才能自动计算。
为解除这一局限性,在远程机器上安装日志和跟踪分析器附带的 IBM 代理控制器。
1.2.7 内存不足异常最多可将 25MB 的日志文件导入到工作空间并在日志和跟踪分析器中打开它们。打开日志文件所需的时间取决于文件中的日志记录数,并且可能出现“内存不足”异常。
要解决此问题,编辑 ac.bat 或 ac.sh 并通过将“-Xmx”选项的值从“500”增加至更高的值(如“1000M”)来增加内存,但增加内存会导致启动速度降低,或者为机器添加更多物理内存。或者,使用日志和跟踪分析器的大型日志支持功能。
1.2.8 在 Linux GTK 驱动程序上的导入日志文件向导中添加日志文件时发生索引值超出限制错误在导入日志文件时,如果试图在“添加日志文件”向导中单击确定,则将导致索引值超出限制错误。这是因为要添加的日志文件还未选择版本。
确保已在“添加日志文件”向导“详细信息”选项卡的版本下拉列表中选择了有效的版本选项。
1.2.9 不能从 Linux GTK 驱动程序中的 .metadata 文件夹导入 LoggingUtil.log 文件不能导入任何工作空间目录的 .metadata 文件夹中的 LoggingUtil.log 文件,原因是导入日志向导中的文件选择对话框未显示 .metadata 文件夹。
要解决此问题,将 LoggingUtil.log 文件从 .metadata 文件夹复制至其它可视文件夹目录。
1.2.10 不能使用基于规则的解析器导入需要转换的日志文件不能使用基于规则的相应解析器导入需要从本机格式转换为文本格式的日志文件(通过“文件”>“导入”>“日志文件”)。下列日志文件会受到影响:
为解除这一局限性,使用相应的基于静态的解析器(如果有)。
1.2.11 不支持使用静态解析器来连续监视日志文件不能使用静态 Java 解析器类来连续监视日志文件。如果有基于规则的解析器,则应使用该解析器来连续监视这些日志文件。
1.2.12 未显示导入日志文件时发生的错误如果导入日志文件时发生错误,有时不会显示错误消息并且日志视图中不会显示任何记录,或者日志视图中的记录中会显示不正确的数据。确保对要导入的日志文件选择了正确的日志类型和版本。日志和跟踪分析器不会对要导入的日志文件类型进行任何验证。
1.2.13 导入 WebSphere Application Server activity.log 文件时的局限性从非英语机器中或在非英语机器上导入 WebSphere Application Server 活动日志文件时,基于规则的日志文件解析器不能成功地将日志记录数据映射至公共基本事件。而是,某些日志记录数据可能会出现在公共基本事件的不正确字段中。
要解决此问题,从非英语机器中或在非英语机器上导入 WebSphere Application Server 活动日志文件时,应使用静态日志文件解析器。
1.2.14 导入不同语言环境中生成的日志文件时的局限性当导入包含时间戳记的日志文件(该时间戳记所处的语言环境不同于日志和跟踪分析器执行所处的语言环境)时,基于规则的日志文件解析器有时不能正确解析时间戳记和其它日志记录数据。例如,如果将英语 IBM HTTP Server 访问日志文件导入到正在日语机器上运行的日志和跟踪分析器中,生成的公共基本事件中的 creationTime 值将为零并且公共基本事件消息字段将为空白。
要解决此问题,当导入包含时间戳记的日志文件(该时间戳记所处的语言环境不同于当前机器的语言环境)时,应使用静态日志文件解析器(如果有)。
1.2.15 导入失败并显示 InvocationTargetException 消息如果日志和跟踪分析器未正确安装并且缺少某些文件,则导入日志文件可能会失败并显示以下记录消息:
java.lang.reflect.InvocationTargetException
要解决此问题,重新安装日志和跟踪分析器。注意:在 Windows XP 上进行安装时,不要使用 Windows XP 本机解压缩实用程序。有关更多详细信息,请参阅下面的使用 Windows XP 解压缩实用程序进行解压缩时出现问题一节。
在“新建日志关联”向导中,仅显示“可用的日志”列表,并且该列表是空的。这是因为只显示了向导页的左边部分。
要解决此问题,尝试调整向导页的大小以便显示“选择的日志”列表和操作按钮。另一个变通方法是在“日志导航器”视图中选择要关联的日志文件,然后单击“新建日志关联”按钮。
1.3.2 第一次启动工作台后对插件记录级别的修改不被接受如果在第一次启动工作台后在插件的 plugin.xml 文件中修改了它的记录级别(通过 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 扩展点),在以后启动工作台时不会接受这一更改。在插件的 plugin.xml 文件中指定的记录级别由 Eclipse 运行时在第一次启动工作台时高速缓存。以后启动工作台时将使用插件记录级别的高速缓存值,不管在 plugin.xml 文件中作何修改也是如此。
要解决这一问题,删除 <工作台安装目录>\configuration 目录然后重新启动工作台。 或者,可在“记录首选项”页面(窗口 > 首选项 > 记录)上修改插件的记录级别然后重新启动工作台。
1.3.3 使用 Windows XP 解压缩实用程序进行解压缩时出现问题在 Windows XP 上安装日志和跟踪分析器时,使用 Windows XP 本机解压缩实用程序来解压缩日志和跟踪分析器运行时文件时出现问题。某些目录和文件不会解压缩。这一问题将导致无法使用日志和跟踪分析器来导入某些日志文件类型。
为解决此问题,在 Windows XP 上进行安装时使用另一解压缩实用程序,如 WinZip 或 UnZip。
1.3.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)。
要解决此问题,尝试在 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。
代理程序交互视图和进程交互视图在日志文件的“时序图”视图不受支持。
这一问题目前没有变通方法。
2.2 “时序图”视图显示的返回调用指向的位置不正确“时序图”视图显示的返回调用指向的位置可能不正确,这些调用指向空格而不是方法节点。
这一问题目前没有变通方法。
2.3 概要分析导航器的刷新视图命令对跟踪交互不起作用概要分析导航器的刷新视图命令对跟踪交互不起作用。
变通方法是在概要分析树中选择另一节点,然后再次选择先前的节点。
2.4 “在服务器上进行概要分析”概要分析选项对 J2FF 请求概要分析程序不适用“对服务器连接进行概要分析”向导允许您配置概要分析选项(例如,概要分析集合或概要分析过滤器)。这些概要分析选项对任何选择要连接的 J2EE 请求概要分析程序不适用。这些概要分析选项仅对 PiAgent 概要分析程序适用。
*2.5 “新建过滤器集合”在非英语工作台上创建英语过滤规则,并且英语过滤规则在保存时被视为 INCLUDE在非英语工作台上创建新过滤器集合时,新过滤器目标最初以英语显示。而且,以英语显示的过滤规则将被忽略并且在保存时总是被视为 INCLUDE。
变通方法是使用封装的过滤器集合进行概要分析并且修改(添加/除去)用于概要分析的过滤器,或者通过应用并关闭启动向导来保存新的过滤器集合,然后重新打开并在进行概要分析之前修改它们。
注意:这已经在 V6.0.0.1 中进行了修正。
返回到主自述文件