以独立方式对应用程序进行概要分析

下列信息适用于 Windows。 下列信息适用于 AIX。 下列信息适用于 Linux。 下列信息适用于 Solaris。 可以以独立方式对应用程序进行概要分析(即,从命令行进行)而不必安装 Hyades 工具。但是,确实需要在要进行概要分析的应用程序所在的机器上安装代理控制器。

可以通过调用“Java 概要分析代理程序”(它是一个库,它连接至“Java 虚拟机”(JVM)以捕获和记录 Java 应用程序的行为)来以独立方式对应用程序进行概要分析。代理程序的输出是以 XML 段表示的。

使用 -Xrun Java 选项来调用“Java 概要分析代理程序”:

   -XrunpiAgent:agent_parm[,agent_parm]*

例如,要使用在 myFilters.txt 文件中定义的过滤器并将概要分析会话中的数据引导至称为 PEProfilingData 的文件来对 PerformanceExample.java 进行概要分析,应在命令行上输入下列内容:
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

通过增大 -XrunpiAgent 参数可以指定几种不同的方式来运行概要分析代理程序。参数 agent_parm 可使用下列其中一个值:

类过滤器文件的格式

过滤器文件应该按以下格式指定 package/classmethodmode 这三个字段:
   package/class method mode

其中:

package/class
此字段用来指定包或类名的模式。应该将此模式指定成不带嵌入空白的字符串。该字符串可以在字符串开头或字符串末尾包含一个星号(*),例如 *.mypackageorg.mycompany.*。* 匹配零个或多个字符,这使得模式成为通用前缀或后缀模式。还可指定单个 * 以表示所有字符串。
方法
此字段用来指定方法名的模式。应该将此模式指定成不带嵌入空白的字符串,指定规则与 class 字段相同。
mode
此字段指定概要分析是要包括还是要排除与模式相匹配的包或类。mode 的值为 INCLUDE 或 EXCLUDE。

过滤器模式是按照指定它们的顺序来处理的,直到第一个模式匹配成功为止。如果类名与指定的任何过滤器模式都不匹配,则缺省情况为包括(INCLUDE)该类。

Java 概要分析代理程序控制

当使用 server=enabledserver=controlled 参数启动“Java 概要分析代理程序”时,与代理程序进行的通信是使用客户机工作台并通过主机上的代理控制器来进行的。

注意

相关概念
概要分析工具概述
概要分析资源

相关任务
在 AS/400 上以独立方式对应用程序进行概要分析
启动或连接 Java 进程
使用“概要分析监视器”视图