概要分析和记录工具 - 发行说明

1.0 简介
2.0 受支持的软件和规范
3.0 限制
   3.1 安全性功能部件不可用
   3.2 在 Linux 上升级代理控制器
   3.3 代理控制器可能无法在 AIX 上启动
   3.4 安装和卸载期间产生的其它错误
   3.5 内存不足错误
4.0 已知问题
   4.1 打开和查看跟踪文件
   4.2 导入日志文件
   4.3 在日志交互作用视图中显示较大的文件
   4.4 隐藏被日志交互作用视图忽略的自引用调用
   4.5 对代理程序交互作用和进程交互作用视图的支持
   4.6 从 Solaris 导入日志文件
   4.7 不能导入包含非 ASCII 字符的日志文件
   4.8 不能对独立 WebSphere Application Server 5.0.2 进行概要分析
   4.9 重新连接代理程序后产生重复方法和类数据
   4.10 IBM HTTP Server 1.3.26.2 未列示在导入向导中
   4.11 在启动或连接后不能更改代理程序属性

1.0 简介

此发行说明阐述在工作台的“概要分析和记录”透视图(包括“日志”视图)中可用的性能和内存概要分析以及分析工具。

文档的附加源代码


使用样本的指南
从“日志和跟踪分析器”中,调用文件 > 新建 > 示例... 并选择日志分析器和相关样本树形视图。选择 Apache 日志相关/分析器样本菜单项并单击下一步按钮。然后单击完成按钮。将自动创建样本。


创建解析器、相关引擎和分析引擎的指南
这些指南可在以下网址找到:http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html

2.0 受支持的软件和规范

对 Java Applet 进行概要分析
要对在 Eclipse 下创建的 Java Applet 进行概要分析:

1. 使用“运行”菜单来选择运行...
2. 选择 Java Applet 并单击新建
3. 选择自变量选项卡。
4. 在 VM 自变量中指定以下内容:-XrunpiAgent:server=controlled
5. 单击运行。注意,在连接至进程之前应用程序将不会运行。
6. 切换至概要分析和记录透视图。
7. 使用“概要分析”菜单来选择连接 -> Java 进程
8. 使用向导来连接至该进程。
9. 开始监视该代理程序。此时应用程序应该运行。
注意,还可以“启用”方式对进程进行概要分析。有关更多详细信息,请参阅 RAC 文档。

自述文件使用 Hyades Apache 公共记录样本在执行步骤部分的“第 3 步”中没有指定正确的记录代理程序名称。记录代理程序的正确名称为 org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample

3.0 限制

3.1 安全性功能不可用

“IBM 代理控制器”的“安全性”功能不可用。当在安装期间提示启用或打开“安全性”时,选择禁用

3.2 在 Linux 上升级代理控制器

如果在 Linux 上从版本 5.0.1 或更早版本升级“代理控制器”,则必须先使用以下命令卸载该版本:

rpm -e ibmrac-5.0.1-0
在卸载较旧的版本之后,可以使用以下命令安装新版本:
rpm -U ibmrac-5.1.0-0.i386.rpm

3.3 代理控制器可能无法在 AIX 上启动

“代理控制器”可能无法在 AIX 上启动,出现以下消息:

RAServer 未能启动。
通常会在下列情况下导致此问题:TCP/IP 端口 10002 正由在系统上运行的另一进程使用,或者“代理控制器”刚刚停止。

变通方法:如果端口 10002 正由另一进程使用,则可以通过编辑 serviceconfig.xml 文件来更改端口号。这在文档中作了描述。

3.4 安装和卸载期间产生的其它错误

如果在安装或卸载期间遇到错误,这可能是由于通过运行进程装入了“代理控制器”的对象文件。要确保可以修改这些对象文件,执行下列步骤:

  1. 关闭工作台。
  2. 终止包含 Java 概要分析代理程序J2EE 请求概要分析程序的所有 java.exe 进程。
  3. 关闭“服务”窗口。

3.5 内存不足错误

有时工作台在处理大量数据时可能会用光内存。根据正在使用的 JRE,这将在不同阶段发生。例如,在某些情况下,SUN 1.4.1 将比 IBM 1.3.1 或 IBM 1.4.1 更快用完内存。

变通方法:使用 -Xmx JVM 自变量来增加“堆”分配。建议使用 -Xmx200M,但根据机器配置和应用程序需要,可能需要更大的量。

4.0 已知问题

4.1 打开和查看跟踪文件

不能使用“记录”工具打开和查看使用日志分析器跟踪输出格式生成的 WebSphere Application Server 跟踪文件。

变通方法:在生成要使用“记录”工具打开和查看的跟踪文件之前,将 WebSphere Application Server 跟踪输出格式设置为基本高级

4.2 导入日志文件

可将高达 25MB 的日志文件导入到工作空间中并在“日志和跟踪分析器”中打开。打开日志文件的时间量取决于文件中日志记录的数目,可能获得“内存不足”异常。

变通方法:通过按如下所示启动 Eclipse 来增加内存:

"eclipse.exe -vmargs -Xmx800M" 或将更多物理内存添加至该机器。

4.3 在日志交互作用视图中显示较大的文件

当在“日志交互作用”视图中显示较大的日志文件时,“时序图”概述将不显示任何日志文件。概述按钮从视图的底部移至顶部,但是视图本身没有宽度。

变通方法:无。

4.4 隐藏被日志交互作用视图忽略的自引用调用

“首选项”页面上显示的针对“时序图”视图(窗口 > 首选项 > 概要分析和记录 > 时序图)的隐藏自引用调用的选项被“日志交互作用”视图忽略。

变通方法:无。

4.5 对代理程序交互作用和进程交互作用视图的支持

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

变通方法:无。

4.6 从 Solaris 导入日志文件

不能正确地从 Solaris 导入日志文件。

变通方法:无。Solaris 驱动程序不稳定,在不久的将来将提供更新。

4.7 不能导入包含非 ASCII 字符的日志文件

如果日志文件的内容包含非 ASCII 字符(例如,0xFF 0xFB ...),将不会正确导入该日志文件。

变通方法:从日志文件中除去这些非 ASCII 字符。

4.8 不能对独立 WebSphere Application Server 5.0.2 进行概要分析

对 WebSphere Application Server V5.0.2 进行概要分析将挂起服务器或使其崩溃,除非您正在使用嵌入在此产品中的应用程序服务器。

解决方案:如果希望对并非此产品一部分的 WebSphere Application Server V5.0.2 实例进行概要分析,则需要与 WebSphere 支持机构联系以获取修订。更多信息可在 此处找到。

4.9 重新连接代理程序后产生重复方法和类数据

重新连接至位于同一项目和监视目标下的同一代理程序将导致报告重复的类和方法。

当期望由另一个资源来连接代理程序时,“从代理程序拆离”是很有用的。

变通方法:选择暂停监视以停止收集概要文件数据,然后,再次选择开始监视以继续进行概要分析。

4.10 IBM HTTP Server 1.3.26.2 未列示在导入向导中

IBM HTTP Server V1.3.26.2 未作为受支持的日志格式列示在“导入向导”中。将在 WebSphere Application Server V5.0.2 中使用此服务器。可使用 IBM HTTP Server 1.3.26.1 从 IBM HTTP Server 1.3.26.2 成功导入日志。

4.11 在启动或连接后不能更改代理程序属性

一旦启动或连接创建了代理程序,就不能应用代理程序属性中的更改(例如,选项或过滤器)。

变通方法:拆离代理程序然后将其重新连接至具有新选项和过滤器的另一监视器。

返回到主自述文件