2.4. 使用 JMC 代理创建预设置
您可以在 JMC 控制台中配置 JMC Agent 实例。
JMC 控制台提供以下 JMC Agent 配置选项,用于名称,但有几个:
- 使用 Agent Preset Manager 选项创建自定义预设置。
- 将 XML 配置导入到您的 JMC 代理预设置中。
-
使用
defineEventProbes函数添加自定义 JFR 事件的 XML 描述。 - 将活跃的自定义 JFR 事件存储为预设,以便您可以在以后的阶段检索它们。
先决条件
- 在 JMC 控制台中启动 JMC 代理实例。
流程
- 您可以通过点菜单栏中的 Window 来创建新预设置,然后点 JMC Agent Preset Manager 菜单项。JMC Agent Configuration Preset Manager 向导会在 JMC 控制台中打开。
点 Add 按钮访问 Edit Preset Global Configurations 窗口。
图 2.4. 编辑 Preset Global configuration 窗口

在此窗口中,您可以为预先设置输入一个名称。另外,您可以为您要注入目标 JVM 的任何事件输入一个类前缀。您还可以选中 AllowtoString 复选框和 Allow Converter 复选框。
点 Next 按钮。此时会打开 Add 或 Remove Preset Events 窗口。在此窗口中,您可以为预先设置添加新的事件、编辑事件或删除事件。
图 2.5. 添加或删除预设置事件

按照向导的说明,您可以完成以下步骤:
- 编辑事件配置
- 编辑参数或返回值步骤
编辑参数或返回值 Capturing
提示您可以选择每个向导步骤中的任何可用按钮来完成所需的配置,如 添加、Remove 等等。您可以单击任何阶段的 Back 按钮来编辑之前的向导步骤。
- 点 Finish 按钮返回到 Add 或 Remove Preset Events 窗口。
- 点 Next。此时会打开 Preview Preset Output 窗口。
在点 Finish 按钮前查看生成的 XML 数据:
图 2.6. 预览预设置输出

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

其他资源
- 有关 JMC XML 属性的详情,请参考 JMC 代理插件属性。