使用 Profiler

本节介绍了 Profiler 图形用户界面的功能以及如何使用这些功能。信息通过以下方式进行组织：

• 指定 Profiler 选项

• 使用 "IDM Profiler" 视图

• 使用“快照视图”

• 使用弹出式菜单选项

• 搜索快照

• 保存快照

指定 Profiler 选项

“Profiler 选项”对话框由以下选项卡组成：

• 模式

• IDM 对象过滤器

• Java 过滤器

• 其他

使用这些选项卡上的选项，可指明要对哪些对象进行性能分析，以及要显示在性能分析中的元素。

指定 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 对象过滤器”选项卡提供了以下选项：

• 显示 IDM 对象详细信息

  • 选中此复选框可以在快照中包含所有已执行的表单、工作流和 XPRESS 元素。

  • 清除此复选框可以仅在快照中包含以下元素：

    • <invoke>

    • <new>

    • <Rule>

    • <Form>

    • <WFProcess>

    • <ExScript>

    • <ExDefun>

    • <FieldRef>

    • <Action>（用于工作流应用程序标注）

• 包含匿名源

  ---

  注 –

  匿名源是实时生成的表单或表单部分（如登录表单或 MissingFields 表单），它与驻留在 Identity Manager 系统信息库中的持久性表单之间没有对应关系。

  ---

  • 选中此复选框可以在快照中包含匿名源。

  • 清除此复选框可以从快照中排除匿名源。

Java 过滤器

选择“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" 视图

IDM Profiler 视图由以下区域组成：

• “当前项目”区域

• 控制区域

• “状态”区域

• “性能分析结果”区域

• “已保存的快照”区域

“当前项目”区域

“当前项目”区域包含一个下拉菜单，该菜单列出了所有的当前项目。使用此菜单可以选择要分析的项目。

控制区域

“控制”区域包含四个图标，如下表中所述：

“状态”区域

“状态”区域会报告您是否与主机进行了连接，并提供有关 Profiler 启动、运行和停止的状态信息。

“性能分析结果”区域

“性能分析结果”区域包含两个图标，如下表中所述：

“已保存的快照”区域

“已保存的快照”区域提供了所有已保存快照的列表。

保存快照中提供了保存快照的说明。

此外，还可以使用以下按钮来管理这些快照：

• 打开：单击此按钮可以在“快照视图”窗口中打开已保存的快照。

  ---

  提示 –

  还可以在“已保存的快照”列表中双击某个快照以打开该快照。

  ---

• 删除：在“已保存的快照”列表中选择一个快照，然后单击此按钮以删除选定的快照。

• 另存为：在列表中选择一个快照，然后单击此按钮将该快照保存到外部的任意位置。

• 加载：单击此按钮可以将任意位置的快照加载到“快照视图”窗口中。

使用“快照视图”

打开快照时，结果会显示在位于 Identity Manager IDE 右上方的“快照视图”窗口中。

快照提供了几种数据视图，将在以下各节中进行介绍：

• “调用树”视图

• “热点”视图

• “反向跟踪”视图

• “被调用者”视图

“调用树”视图

“调用树”视图由一个树表组成，该树表显示了整个系统的调用计时和调用计数。

此树表包含三列：

• “调用树”列：列出了所有节点。

  顶层节点为以下内容之一：

  • Thread.run() 方法，用于系统中的各种后台线程

    例如，如果启用了 Java 性能分析，则会看到 ReconTask.WorkerThread.run() 方法。

  • 请求计时

    例如，如果查看 idm/login.jsp URL，则会看到 idm/login.jsp 的顶层条目。对于此条目，“时间”列中显示的数据表示一个或多个请求的总时间。“调用次数”列中显示的数据表示调用该页面的总次数。可以随后深入研究该数据，以了解是哪些调用耗用了这些时间。

  ---

  注 –

  “调用树”还包含“自用时间”节点。“自用时间”值表示该节点自身耗用的时间。（有关详细信息，请参见统计信息注意事项。）

  ---

• “时间”列：列出了从其父节点调用每个节点时所耗用的时间。将使用相对于父节点时间的百分比来表示。

• “调用次数”列：列出了从其父节点调用每个节点的次数。

“热点”视图

“热点”视图提供了节点的平面化列表，用于显示汇总调用计时（不考虑父节点）。

此视图包含以下列：

• 自用时间：列出了每个节点耗用的总时间。

• 调用次数：列出了从其父节点调用每个节点的总次数。

• 时间：列出了每个节点及其所有子节点耗用的总时间。

“反向跟踪”视图

“反向跟踪”视图提供了反向的调用栈，显示了从中调用每个节点的所有调用链。

可以使用这些统计信息来回答如下问题：如果我删除自此节点开始的特定调用链，将节省多少时间？

可以从其他任何快照视图中访问“反向跟踪”视图，方法是右键单击某个节点（称为根节点），然后从弹出式菜单中选择“显示反向跟踪”。

“时间”和“调用次数”数据值在“反向跟踪”视图中具有某些不同的含义：

• 时间：此列中的值表示从给定调用链调用根节点时，根节点耗用的时间。

• 调用次数：此列中的值表示从给定调用链调用根节点的次数。

“被调用者”视图

“被调用者”视图提供了节点（称为根节点）的汇总调用树（不考虑其父调用链）。

如果存在一个问题区域，并且整个主调用树中的许多位置都调用了该区域，当您想查看该节点的整体性能分析时，这些统计信息将非常有用。

可以从其他任何快照视图中访问“被调用者”视图，方法是右键单击某个节点（称为根节点），然后从弹出式菜单中选择“显示被调用者”。

“被调用者”视图中所用的时间和调用次数数据值与那些在“调用树”视图中使用的数据值具有相同的含义。

使用弹出式菜单选项

右键单击“调用树”视图或“热点”视图中的任意节点，将显示一个弹出式菜单，其中的选项如下表中所述：

搜索快照

使用位于“快照视图”窗口顶部的“搜索”图标 ，可以在“调用树”视图或“热点”树中按名称来搜索节点。

此外，还可以右键单击“调用树”视图或“热点”视图中的任意节点，然后从弹出式菜单中分别选择“在‘调用树’视图中查找”或“在‘热点’视图中查找”来搜索节点。

保存快照

Profiler 提供了几个选项来保存快照。有关这些选项的描述，请参见下表：