第 6 章 与代理利用的动态 JFR 记录集成以进行归档
当您启用 Cryostat 代理根据 MBean 自定义触发器启动动态 JFR 记录时，您还可以将这些 JFR 记录与代理 harvester 系统集成。此集成意味着，任何由 MBean 自定义触发器生成的 JFR 记录数据都会定期捕获到 JFR 快照中，并推送到 Cryostat 服务器以进行归档。
带有代理利用的 MBean 自定义触发器
代理 harvester 是另一个可配置的功能，它允许 Cryostat 代理根据给定的事件模板在代理启动时自动启动 JFR 记录。agent harvester 包含一个可配置的属性，可用于定义用于捕获和上传记录快照到 Cryostat 服务器的调度。
通过定义 MBean 自定义触发器和没有 harvester 模板的代理利用，您可以获得一个设置，代理会在其中进行这两个操作：
- 代理会根据 MBean 自定义触发器动态启动 JFR 记录。
- 代理使用配置的 harvester 周期来定期捕获记录数据的快照，并将这些数据上传到 Cryostat 服务器。
在这种情况下，代理将继续捕获记录数据，直到您手动停止动态 JFR 记录或主机 JVM 关闭。
配置代理利用期
当您将目标应用程序配置为加载 Cryostat 代理时，您还可以配置代理利用周期来启用 JFR 记录数据的定期上传。您可以以毫秒为单位指定 harvester 周期的值。默认情况下，没有启用 Cryostat 代理来执行任何调度的 JFR 记录数据上传。
您可以通过以下任一方式配置代理利用周期：
- 使用 JVM 系统属性标记
以下示例演示了如何使用 JVM 系统属性标记配置 harvester 周期：
-Dcryostat.agent.harvester.period-ms=1000
- 使用环境变量
以下示例演示了如何使用环境变量配置 harvester 周期：
- name: CRYOSTAT_AGENT_HARVESTER_PERIOD_MS value: 1000
前面的例子显示了 harvester period 的值为 1000。根据此示例，代理会上传每 1000 毫秒进行归档的 JFR 记录数据（即，在常规的 1 秒时）。
Cryostat 支持以下不同方法启动 JFR 记录：
- 您可以从 Cryostat web 控制台手动启动记录。
- Cryostat 代理可以根据 MBean 自定义触发器动态启动记录。
- Cryostat 代理可以根据给定的 harvester 模板在代理启动时自动启动记录。
- Cryostat 服务器可以通过 JMX 或代理 HTTP 连接发送按需请求，以根据自动化规则启动记录。
在这种情况下，代理利用语设置控制所有 JFR 记录数据的捕获和上传，无论系统中启动 JFR 记录的方式是什么。
