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