本节介绍了 Profiler 图形用户界面的功能以及如何使用这些功能。信息通过以下方式进行组织:
“Profiler 选项”对话框由以下选项卡组成:
使用这些选项卡上的选项,可指明要对哪些对象进行性能分析,以及要显示在性能分析中的元素。
指定 Profiler 选项后,单击“确定”可启动 Profiler。根据项目配置,Profiler 将执行以下两项操作之一:
如果使用的是常规 Identity Manager 项目(包含嵌入式 Identity Manager 实例),则 Profiler 会执行完整的生成过程,并将项目部署到 NetBeans 应用服务器中,然后启动 Profiler。
如果使用的是常规 Identity Manager 项目(包含外部 Identity Manager 实例)或远程 Identity Manager 项目,则 Profiler 会附加到为该项目配置的 Identity Manager 实例上。
可以选择 "IdM" ->“设置 Identity Manager 实例”来控制用于该项目的 Identity Manager 实例操作。
“模式”选项卡提供了以下选项:
仅 IDM 对象:选择该选项可分析表单、规则、工作流和 XPRESS 对象,但不能分析 Java 对象。
Java 和 IDM 对象:选择该选项可分析表单、Java、规则、工作流和 XPRESS 对象。
如果使用的是常规 Identity Manager 项目(包含外部 Identity Manager 实例)或远程 Identity Manager 项目,则“Java 和 IDM 对象”选项不可用。
在运行 Profiler 时,无法更改“模式”选项。必须先停止 Profiler 才能更改该选项。
“IDM 对象过滤器”选项卡提供了以下选项:
显示 IDM 对象详细信息
包含匿名源
匿名源是实时生成的表单或表单部分(如登录表单或 MissingFields 表单),它与驻留在 Identity Manager 系统信息库中的持久性表单之间没有对应关系。
选中此复选框可以在快照中包含匿名源。
清除此复选框可以从快照中排除匿名源。
选择“Java 过滤器”选项卡可以执行以下操作:
包含或排除 Java 过滤器
创建新的过滤器
删除现有的过滤器
恢复默认的过滤器
Java 过滤器以方法模式的形式提供,它们采用根据规范的方法名称执行包含或排除操作的模式来表示。其中,规范的方法名称为:
fully-qualified-class-name.method-name( parameter-type-1, parameter-type-2, ... )
对于构造函数,method-name 为 <init>。
下面列举了一些示例:
要排除所有构造函数,请启用“排除”复选框,并添加以下过滤器:
*.<init>(*)
要排除所有包含单个 org.w3c.dom.Element 参数的构造函数,请启用“排除”复选框,并添加以下过滤器:
*.<init>(org.w3c.dom.Element)
要排除所有 Identity Manager 类,请启用“排除”复选框,并添加以下过滤器:
"com.waveset.*" "com.sun.idm.*"
要仅分析自定义代码,请禁用“排除”复选框,并删除初始的 * include 过滤器,然后添加以下过滤器:
"com.yourcompany.*"
最后两个示例目前是等效的,因为这些过滤器仅会应用于自定义类和 Identity Manager 类。
如有必要,可以通过适当修改 build.xml 中的以下行来分析其他 JAR。例如,
<instrument todir="${lighthouse-dir-profiler}/WEB-INF" verbose="${instrumentor.verbose}" includeMethods="${profiler.includes}" excludeMethods="${profiler.excludes}"> <fileset dir="${lighthouse-dir}/WEB-INF"> <include name="lib/idm*.jar"/> <include name="classes/**/*.class"/> </fileset> </instrument> |
默认情况下,该配置包含所有自定义类和大多数 Identity Manager 类。强制排除了一些 Identity Manager 类,这是因为启用这些类会中断 Profiler 的运行。
例如,会排除工作流、表单和 XPRESS 引擎中的类,否则在分析 Java 和 Identity Manager 对象时,Profiler 将会生成难以理解的快照。
请注意,Java 过滤器将提供比 IDM 对象过滤器更细的过滤粒度。因此,使用 Java 分析会显著增加执行时间的开销,从而使性能分析结果出现巨大的偏差。由于是解释而非编译 Identity Manager 对象,因此分析开销可以忽略不计。因此,举例来说,根本没有理由排除工作流 A 而包含工作流 B,等等。
在运行 Profiler 时,不能修改 Java 过滤器。必须先停止 Profiler 才能更改 Java 过滤器。
“其他”选项卡提供了以下选项:
删除执行时间为 0 的快照节点:
如果希望快照包含所有已执行实体的调用信息(即使其执行时间为零),则需要禁用此选项(默认设置)。
即便是对于没有执行时间的节点,包含其调用次数信息可能也很有用。
启用此选项会删除这些节点,从而您可以关注最相关的性能分析数据。此外,启用此选项可以大大降低 Profiler 快照的大小。
Profiler 启动时自动打开浏览器:
如果希望在启动 Profiler 时自动打开浏览器(指向要进行性能分析的 Identity Manager 实例),请启用此选项(默认设置)。
如果不希望打开浏览器,则禁用此选项。
在快照中包含 Java 源:
启用此选项(默认设置)可以在快照中包含性能分析数据引用的任何 Java 方法的 Java 源。应始终将此设置用于字段中的快照。自定义 Java 相对较小,包含它对于支持工作很有价值。
仅在分析 Identity Manager 并且具有完整的 Identity Manager 源时,才禁用此选项。
在这种情况下,您不希望包含 Identity Manager 源,因为包含它会生成非常大的快照。(有关详细信息,请参见 Profiler 查找和管理源的方式。)
IDM Profiler 视图由以下区域组成:
“当前项目”区域包含一个下拉菜单,该菜单列出了所有的当前项目。使用此菜单可以选择要分析的项目。
“控制”区域包含四个图标,如下表中所述:
图标 |
名称 |
用途 |
---|---|---|
|
启动 Identity Manager Profiler |
启动 Profiler 并打开“Profiler 选项”对话框。 |
|
停止 Identity Manager Profiler |
停止 Profiler。 |
|
重置收集的结果 |
重置截止到此刻您收集的所有分析结果。 |
|
修改性能分析 |
重新打开“Profiler 选项”对话框,以便您可以更改任何设置来修改当前的分析结果。 |
“状态”区域会报告您是否与主机进行了连接,并提供有关 Profiler 启动、运行和停止的状态信息。
“性能分析结果”区域包含两个图标,如下表中所述:
图标 |
名称 |
用途 |
---|---|---|
|
启动 Identity Manager Profiler |
启动 Profiler 并打开“Profiler 选项”对话框。 |
|
重置收集的结果 |
重置截止到此刻您收集的所有分析结果。 |
“已保存的快照”区域提供了所有已保存快照的列表。
保存快照中提供了保存快照的说明。
此外,还可以使用以下按钮来管理这些快照:
打开:单击此按钮可以在“快照视图”窗口中打开已保存的快照。
还可以在“已保存的快照”列表中双击某个快照以打开该快照。
删除:在“已保存的快照”列表中选择一个快照,然后单击此按钮以删除选定的快照。
另存为:在列表中选择一个快照,然后单击此按钮将该快照保存到外部的任意位置。
加载:单击此按钮可以将任意位置的快照加载到“快照视图”窗口中。
打开快照时,结果会显示在位于 Identity Manager IDE 右上方的“快照视图”窗口中。
快照提供了几种数据视图,将在以下各节中进行介绍:
“调用树”视图由一个树表组成,该树表显示了整个系统的调用计时和调用计数。
此树表包含三列:
“调用树”列:列出了所有节点。
顶层节点为以下内容之一:
Thread.run() 方法,用于系统中的各种后台线程
例如,如果启用了 Java 性能分析,则会看到 ReconTask.WorkerThread.run() 方法。
请求计时
例如,如果查看 idm/login.jsp URL,则会看到 idm/login.jsp 的顶层条目。对于此条目,“时间”列中显示的数据表示一个或多个请求的总时间。“调用次数”列中显示的数据表示调用该页面的总次数。可以随后深入研究该数据,以了解是哪些调用耗用了这些时间。
“调用树”还包含“自用时间”节点。“自用时间”值表示该节点自身耗用的时间。(有关详细信息,请参见统计信息注意事项。)
“时间”列:列出了从其父节点调用每个节点时所耗用的时间。将使用相对于父节点时间的百分比来表示。
“调用次数”列:列出了从其父节点调用每个节点的次数。
“热点”视图提供了节点的平面化列表,用于显示汇总调用计时(不考虑父节点)。
此视图包含以下列:
自用时间:列出了每个节点耗用的总时间。
调用次数:列出了从其父节点调用每个节点的总次数。
时间:列出了每个节点及其所有子节点耗用的总时间。
“反向跟踪”视图提供了反向的调用栈,显示了从中调用每个节点的所有调用链。
可以使用这些统计信息来回答如下问题:如果我删除自此节点开始的特定调用链,将节省多少时间?
可以从其他任何快照视图中访问“反向跟踪”视图,方法是右键单击某个节点(称为根节点),然后从弹出式菜单中选择“显示反向跟踪”。
“时间”和“调用次数”数据值在“反向跟踪”视图中具有某些不同的含义:
时间:此列中的值表示从给定调用链调用根节点时,根节点耗用的时间。
调用次数:此列中的值表示从给定调用链调用根节点的次数。
“被调用者”视图提供了节点(称为根节点)的汇总调用树(不考虑其父调用链)。
如果存在一个问题区域,并且整个主调用树中的许多位置都调用了该区域,当您想查看该节点的整体性能分析时,这些统计信息将非常有用。
可以从其他任何快照视图中访问“被调用者”视图,方法是右键单击某个节点(称为根节点),然后从弹出式菜单中选择“显示被调用者”。
“被调用者”视图中所用的时间和调用次数数据值与那些在“调用树”视图中使用的数据值具有相同的含义。
右键单击“调用树”视图或“热点”视图中的任意节点,将显示一个弹出式菜单,其中的选项如下表中所述:
菜单选项 |
描述 |
---|---|
转至源 |
选择此选项可以查看 Java 方法、工作流、表单、规则或 XPRESS 所对应节点的 XML 源。有关此视图的详细信息,请参见 Profiler 查找和管理源的方式。 |
显示反向跟踪 |
选择此选项可以访问“反向跟踪”视图。有关此视图的详细信息,请参见“反向跟踪”视图。 |
显示被调用者 |
选择此选项可以访问“被调用者”视图。有关此视图的详细信息,请参见“被调用者”视图。 |
在“热点”视图中查找 |
选择此选项可以在“热点”视图中查找节点。有关此视图的详细信息,请参见“热点”视图。 |
“列表选项”->“排序”-> |
选择此选项可以看到以下选项
|
“列表选项”->“更改可视列” |
选择此选项可以更改在“调用树”或“热点”列表中显示的列。 当显示“更改可视列”对话框时,您可以选择以下一个或多个选项:
|
使用位于“快照视图”窗口顶部的“搜索”图标 ,可以在“调用树”视图或“热点”树中按名称来搜索节点。
此外,还可以右键单击“调用树”视图或“热点”视图中的任意节点,然后从弹出式菜单中分别选择“在‘调用树’视图中查找”或“在‘热点’视图中查找”来搜索节点。
Profiler 提供了几个选项来保存快照。有关这些选项的描述,请参见下表:
图标 |
名称 |
用途 |
---|---|---|
|
“在项目中保存快照”图标(位于“快照视图”窗口的顶部) |
在项目的 nbproject/private/idm-profiler 目录中保存快照。Profiler 视图的“已保存的快照”部分会列出在项目中保存的快照。 |
|
“在外部保存快照”图标(位于“快照视图”窗口的顶部) |
将快照保存到外部的任意位置。 |
|
“另存为”按钮(位于“已保存的快照”区域中) |
将快照保存到外部的任意位置。 |