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

在独立方式下,概要分析选项是在某个文件中指定的。下面描述了该文件的格式以及可在该文件中使用的有效概要分析选项。

可通过使用 * 在概要分析选项文件中进行注释。例如,当处理该文件时,行
* 这是概要文件中的注释
将被概要分析程序忽略。
文件中的所有其他行都遵循此格式:

<option_key> = <option_value>
下表列示了有效的概要分析选项关键字选项值对:
选项关键字 选项值
MONITOR_MODE
此选项控制监视器事件是否显示在跟踪中。有两种监视器事件:监视器竞争事件和监视器等待事件。当一个线程尝试获取另一个线程已经获取的监视器时,监视器竞争事件就会发生。当线程等待监视器时(例如,通过执行 wait() 方法),监视器等待事件就会发生。
all
所有监视器事件都将显示在跟踪中。
none
任何监视器事件都不显示在跟踪中
FILTERS
用来指定在跟踪开始时是否打印已使用的过滤器。
true
在跟踪开始时打印过滤器。
false
在跟踪开始时不打印过滤器。
TRACK_GC_EVENT_TYPES
用来指示应将哪种类型的垃圾回收(GC)事件打印至跟踪。GC 事件的两种类型是对象释放事件和对象移动事件。
none
不打印任何 GC 事件。
deletes
frees
仅打印对象释放事件
moves
仅打印对象移动事件
deletesAndMoves
movesAndFrees
既打印对象释放事件又打印对象移动事件。
ID_STYLE
用来指定打印的对象标识的类型。可能的类型有静态标识浮动标识。“静态标识”本质上是在跟踪中第一次看到某个对象时指定给它的一次性标识。此外,该标识在执行期间不会更改(即使 JVM 在内部移动了对象也不例外)。“静态标识”是概要分析程序通常使用的类型。
“浮动标识”是与对象关联的 JVM 的标识,可在执行期间更改(例如,如果在垃圾回收期间发生了对象移动事件)。
static
仅打印“静态标识”
relocatable
仅打印“浮动标识”
staticAndRelocatable
既打印“静态标识”又打印“浮动标识”
OPTIONS
用来指定是否应将概要分析选项打印到跟踪。
true
将概要分析选项打印到跟踪。
false
不将概要分析选项打印到跟踪。
TIMESTAMPS
用来指定是否应在跟踪中打印时间戳记。
true
打印时间戳记
false
不打印时间戳记
METHOD_COUNTS
用来指定是否应在跟踪结束时打印方法计数。
true
对于被跟踪的方法,在跟踪结束时 JVM 即将关闭之前打印这些方法被调用的总次数。
false
不打印方法计数。
OBJ_ALLOC_IS_ARRAY
用来指定是否打印对象分配的 isArray 属性。(即,当分配对象时,该对象要么是数组,要么不是;isArray 属性就包含该信息。)
true
打印 isArray 属性。
false
不打印 isArray 属性。
STACK_INFORMATION
此选项用来指定应执行那种类型的方法跟踪。
none
不执行任何方法跟踪。这相当于不选择工作台的“概要分析配置”窗口中的执行时间分析
normal
跟踪所有未过滤的方法。
boundary
跟踪所有未过滤的方法以及所有边界方法。这相当于在工作台中选择概要分析配置 > 执行时间分析 > 收集过滤器集排除的边界类
contiguous
跟踪所有未过滤的方法以及出现在方法调用栈上两个未过滤方法之间的所有已过滤的方法。例如,假设 methodA 调用 methodB,methodB 调用 methodC,而 methodC 又调用 methodD。再假设 methodA 和 methodD 未过滤,但 methodB 和 methodC 已过滤。由于 methodB 和 methodC 处于两个未过滤的方法之间,所以也将跟踪它们。
boundaryAndContiguous
与对 STACK_INFORMATION 同时设置了 contiguous 和 boundary 选项值的行为相同。
BOUNDARY_DEPTH
用来在 STACK_INFORMATION 为 boundary 或 boundaryAndContiguous 时指定边界跟踪深度。
Integer
指定边界跟踪深度的整数值。
TICKET
用来指定 ticket 属性是否应该显示在跟踪中。
true
Ticket 属性应显示在跟踪中。
false
Ticket 属性不应显示在跟踪中。
TRACE_MODE
用来指定跟踪方式。基本上,该跟踪方式指定是否跟踪对象(堆)信息。(“none”值有特殊的意义。)
full
跟踪所有可能的对象信息。即,跟踪对象分配以及跟踪与方法调用相关联的对象(如果 STACK_INFORMATION 设置为执行方法跟踪的话)。
none
无论如何都不执行任何跟踪。(如果设置了此值,将覆盖 STACK_INFORMATION 选项,即使该选项设置为跟踪方法调用也不例外。)
noObjectCorrelation
不跟踪对象信息。它与“none”值是不同的,区别在于它仍可进行方法调用跟踪(如果适当设置了 STACK_INFORMATION),但是不会跟踪与方法调用相关联的对象,也不会跟踪任何对象分配信息。
TRACE_ID_REFS
用来指定是否打印跟踪标识引用属性。跟踪引用标识是跟踪特有的标识。
true
打印跟踪标识引用属性。
false
不打印跟踪标识引用属性。

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

相关参考
在 AS/400 上对应用程序进行概要分析的局限性