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 重新连接代理程序后产生重复方法和类数据
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 文件更改端口号。在文档中描述了这一点。
如果安装或卸载期间遇到错误,则这可能是由于“代理控制器”的对象文件是通过运行进程而装入这一事实导致的。要确保可修改对象文件,执行下列步骤:
- 关闭工作台。
- 终止包含 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 中使用此服务器。可使用 IBM HTTP Server 1.3.26.1 从 IBM HTTP Server 1.3.26.2 成功导入日志。
一旦通过启动或连接创建了代理程序,就不能应用代理程序属性(例如,选项或过滤器)中的更改。
变通方法:使用新选项和过滤器拆离代理程序并将它重新连接至另一个监视器。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.