1.0 简介
2.0 受支持的软件和规范
3.0 限制
3.1 安全性功能部件不可用
3.2 在 Linux 上升级代理控制器
3.3 代理控制器可能无法在 AIX 上启动
3.4 安装程序将把 Windows Installer 升级到 2.0
3.5 安装期间发生 1920 错误
3.6 安装和卸载期间发生的其它错误
3.7 内存不足错误
4.0 已知问题
4.1 打开和查看跟踪文件
4.2 导入日志文件
4.3 在日志交互作用视图中显示较大的文件
4.4 隐藏日志交互作用视图忽略的自引用调用
4.5 对代理程序交互作用视图和进程交互作用视图的支持
4.6 从 Solaris 导入日志文件
4.7 不能导入包含非 ASCII 字符的日志文件
4.8 重新连接代理程序后产生重复方法和类数据
4.9 IBM HTTP Server 1.3.26.2 未列示在导入向导中
4.10 在启动或连接之后不能更改代理程序属性
本发行说明阐述从工作台的“概要分析和记录”透视图(包括“日志”视图)提供的性能和内存概要分析工具以及分析工具。
其它文档源
使用样本的指南
从“日志和跟踪分析器”中,调用文件 > 新建 > 示例... 并选择日志分析器和相关样本树形视图。选择 Apache 日志相关/分析器样本菜单项并单击下一步按钮。然后,单击完成按钮。将会自动创建该样本。
创建解析器、相关引擎和分析引擎的指南
可以从以下网址获取这些指南:http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html
对 Java Applet 进行概要分析
要对在 Eclipse 下面创建的 Java Applet 进行概要分析:注意,还可以“启用”方式对进程进行概要分析。有关更多详细信息,请参阅 RAC 文档。
- 1. 使用“运行”菜单来选择运行...。
- 2. 选择 Java Applet 并单击新建。
- 3. 选择自变量选项卡。
- 4. 在 VM 自变量中指定以下内容:
-XrunpiAgent:server=controlled
- 5. 单击运行。注意,应用程序在连接至进程之前将不运行。
- 6. 切换至概要分析和记录透视图。
- 7. 使用“概要分析”菜单来选择连接 -> Java 进程。
- 8. 使用向导来连接至进程。
- 9. 开始监视“代理程序”。此时,应用程序应该运行。
自述文件使用 Hyades Apache 公共记录样本在执行步骤部分的“第 3 步”中没有指定正确的记录代理程序名称。记录代理程序的正确名称是 org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample。
“IBM 代理控制器”的“安全性”功能部件不可用。当在安装期间提示启用或打开“安全性”时,选择禁用或否。
如果要在 Linux 上从版本 5.0.1 或更早版本升级“代理控制器”,则必须首先使用类似于以下内容的命令卸载该版本:
rpm -e ibmrac-5.0.1-0在卸载较旧的版本之后,可以使用以下命令安装新的版本:rpm -U ibmrac-5.1.0-0.i386.rpm
代理控制器可能无法在 AIX 上启动,并且会出现以下消息:
RAServer 未能启动。如果 TCP/IP 端口 10002 正由在系统上运行的另一进程使用或者“代理控制器”刚刚停止,通常就会发生这种情况。变通方法:如果端口 10002 正由另一进程使用,则可以通过编辑 serviceconfig.xml 文件更改端口号。在文档中描述了这一点。
如果 Windows Installer 版本低于 2.0,则安装程序将自动对它进行升级。这将需要重新引导。在系统重新引导之后,“代理控制器”安装将自动继续进行。
如果在安装期间遇到 Windows Installer 错误 1920,则这指示启动“IBM 代理控制器”服务时出现问题。通常,这是由于系统驱动器下面存在称为 Program 的文件而引起的。例如,如果 Windows 被安装在 D: 驱动器下面,则 D:\ 下面存在名为 Program 的文件将阻止“代理控制器”服务启动(如果它安装在缺省位置 D:\Program Files\IBM\IBM Agent Controller 下面的话)。这是由于 Windows 尝试将“代理控制器”服务作为 D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe 启动(这是不正确的)而导致的。要解决此问题,遵循下列步骤:
- 除去或重命名称为 Program 的文件。
- 使用没有空格的目录(例如,D:\IBM_Agent_Controller)安装“代理控制器”。
- 在 Windows 注册表中的密钥名称 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBM Agent Controller\ImagePath 下面,用双引号标记将“代理控制器”的可执行文件的名称引起来。例如:
"D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe"
如果安装或卸载期间遇到错误,则这可能是由于“代理控制器”的对象文件是通过运行进程而装入这一事实导致的。要确保可修改对象文件,执行下列步骤:
- 关闭工作台。
- 终止包含 Java 概要分析代理程序或 J2EE 请求概要分析程序的所有 java.exe 进程。
- 关闭“服务”窗口。
有时,在处理大量数据时,工作台可能会出现内存不足的问题。这种情况将在不同阶段发生,这取决于正在使用的 JRE。例如,在某些情况下,SUN 1.4.1 将比 IBM 1.3.1 或 IBM 1.4.1 早些遇到内存不足的问题。
变通方法:使用 -Xmx JVM 自变量来增加堆分配。建议使用 -Xmx200M,但是可能需要更大的量,这取决于机器配置和应用程序需要。
不能使用“记录”工具打开和查看使用日志分析器跟踪输出格式生成的 WebSphere Application Server 跟踪文件。
变通方法:在生成要使用“记录”工具打开和查看的跟踪文件之前,将 WebSphere Application Server 跟踪输出格式设置为基本或高级。
可将最多为 25 MB 的日志文件导入工作空间并打开到“日志和跟踪分析器”中。打开日志文件的时间量取决于文件中的日志记录数,并且可能会发生“内存不足”异常。
变通方法:通过按如下所示启动 Eclipse 来增加内存:
"eclipse.exe -vmargs -Xmx800M" 或将更多物理内存添加至机器。
当较大的日志文件显示在“日志交互作用”视图中时,“时序图”概述不显示任何日志文件。概述按钮从视图的底部被移至顶部,但视图本身没有宽度。
变通方法:无。
隐藏自引用调用的选项显示在“时序图”视图(窗口 > 首选项 > 概要分析和记录 > 时序图)的“首选项”页面上,且该选项被“日志交互作用”视图忽略。
变通方法:无。
“代理程序交互作用”和“进程交互作用”视图不受日志文件的“时序图”视图的支持。
变通方法:无。
不能从 Solaris 正确导入日志文件。
变通方法:无。Solaris 驱动程序不稳定,将在近期提供一个更新版本。
如果日志文件的内容包含非 ASCII 字符(例如,0xFF 0xFB ...),则日志文件不会被正确导入。
变通方法:从日志文件除去这些非 ASCII 字符。
重新连接至同一项目和监视器目标下的同一代理程序将导致报告重复类和方法。
当期望由另一个资源来连接代理程序时,“从代理程序拆离”是很有用的。
变通方法:选择暂停监视以停止收集概要文件数据, 随后再次选择开始监视以继续进行概要分析。
IBM HTTP Server V1.3.26.2 未作为受支持的日志格式列示在“导入”向导中。此服务器用于 WebSphere Application Server V5.0.2 中。可以使用 1.3.26.1 从 IBM HTTP Server 1.3.26.2 中成功地导入日志。
一旦通过启动或连接创建了代理程序,就不能应用代理程序属性(例如,选项或过滤器)中的更改。
变通方法:使用新选项和过滤器拆离代理程序并将它重新连接至另一个监视器。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.