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 Configuration 窗口。
图 2.4. 编辑预设置全局配置窗口
在这个窗口中，您可以为预设置输入一个名称。另外，您可以为您要注入目标 JVM 的任何事件输入类前缀。您还可以选中 AllowtoString 复选框和 Allow Converter 复选框。
点 Next 按钮。此时会打开 Add or Remove Preset Events 窗口。在这个窗口中，您可以为预设置添加新事件、编辑事件或删除事件。
图 2.5. 添加或删除预设置事件
按照向导的说明，您可以完成以下步骤：
1. 编辑事件配置
2. 编辑参数或返回值步骤
3. 编辑参数或返回值捕获
  提示
  您可以选择每个向导步骤中的任何可用按钮来完成所需的配置，如 Add、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 窗格中的输出示例