2.4. 使用 JMC 代理创建预设置

您可以在 JMC 控制台中配置 JMC Agent 实例。

JMC 控制台提供以下 JMC Agent 配置选项,用于名称,但有几个:

  • 使用 Agent Preset Manager 选项创建自定义预设置。
  • 将 XML 配置导入到您的 JMC 代理预设置中。
  • 使用 defineEventProbes 函数添加自定义 JFR 事件的 XML 描述。
  • 将活跃的自定义 JFR 事件存储为预设,以便您可以在以后的阶段检索它们。

先决条件

  • 在 JMC 控制台中启动 JMC 代理实例。

流程

  1. 您可以通过点菜单栏中的 Window 来创建新预设置,然后点 JMC Agent Preset Manager 菜单项。JMC Agent Configuration Preset Manager 向导会在 JMC 控制台中打开。
  2. Add 按钮访问 Edit Preset Global Configurations 窗口。

    图 2.4. 编辑 Preset Global configuration 窗口

    jmc edit preset 全局配置

    在此窗口中,您可以为预先设置输入一个名称。另外,您可以为您要注入目标 JVM 的任何事件输入一个类前缀。您还可以选中 AllowtoString 复选框和 Allow Converter 复选框。

  3. Next 按钮。此时会打开 Add 或 Remove Preset Events 窗口。在此窗口中,您可以为预先设置添加新的事件、编辑事件或删除事件。

    图 2.5. 添加或删除预设置事件

    jmc add remove preset events
  4. 按照向导的说明,您可以完成以下步骤:

    1. 编辑事件配置
    2. 编辑参数或返回值步骤
    3. 编辑参数或返回值 Capturing

      提示

      您可以选择每个向导步骤中的任何可用按钮来完成所需的配置,如 添加Remove 等等。您可以单击任何阶段的 Back 按钮来编辑之前的向导步骤。

  5. Finish 按钮返回到 AddRemove Preset Events 窗口。
  6. Next。此时会打开 Preview Preset Output 窗口。
  7. 在点 Finish 按钮前查看生成的 XML 数据:

    图 2.6. 预览预设置输出

    jmc preview preset 输出
  8. 点 JMC 控制台窗口右上角的 Load preset 按钮,然后将您的预设上传到 JMC 应用程序。
  9. JMC Agent Configuration Preset Manager 窗口中,点 OK 按钮将预先设置加载到您的目标 JVM 中。JMC 控制台上的 Agent Live Present 面板会显示您的活跃代理配置及其注入的事件。例如:

    图 2.7. Agent Live Present 窗格中的输出示例

    jmc 代理实时配置示例

其他资源