4.3. JFR 记录的标签
当您在 Cryostat 上创建 JDK Flight Recorder (JFR)记录时,您可以通过指定一系列键值对在记录中添加元数据。
另外,您可以将自定义标签附加到目标 JVM 内部的 JFR 记录,以便您可以轻松识别和更好地管理 JFR 记录。
以下列表详细介绍了一些常见记录标签用例:
- 将元数据附加到您的 JFR 记录。
- 在包含相同标签的记录上执行批处理操作。
- 在记录上运行查询时使用标签。
您可以使用 Cryostat 创建监控容器化应用程序中 JVM 性能的 JFR 记录。另外,您可以为目标 JVM 应用程序生成活跃的 JFR 记录的快照,以捕获任何收集的数据(最多指向特定时间)。
4.3.1. 在 JFR 记录中添加标签 复制链接链接已复制到粘贴板!
在 Cryostat 上创建 JFR 记录时,您可以使用标签将包含键值对的元数据添加到记录中。
Cryostat 将默认记录标签应用到创建的 JFR 记录。这些默认标签捕获 Cryostat 用于创建 JFR 记录的事件模板的信息。
您可以在 JFR 记录中添加自定义标签,以便您可以运行满足您的需要的特定查询,如识别特定的 JFR 记录或在具有相同应用标签的记录上执行批处理操作。
先决条件
- 登录到您的 Cryostat web 控制台。
- 为您的 Cryostat 实例创建或选择目标 JVM。
流程
- 在 Cryostat web 控制台中点 Flight Recorder > Capture > Recordings。
- 在 Recordings 面板中,点 Create。
在 Custom Flight Recording 选项卡中,展开 Show metadata options。
注意在 Custom Flight Recording 选项卡中,您必须完成标记为星号的任何强制字段。
点 Add label。
图 4.10. Custom Flight Recording 选项卡下显示的 Add Label 按钮
- 在提供的 Key 和 Value 字段中输入值。例如,如果要在 Key 字段中输入问题,可以在 Key 字段中输入问题,然后在 Value 字段中输入问题类型。
点 Create 创建您的 JFR 记录。然后,会在 Recordings 面板中显示您的记录,以及任何指定的记录标签和自定义标签。
提示您可以从 Flight Recorder > Analyze > Archives 菜单访问归档的 JFR 记录。请参阅 将 JFR 记录上传到 Cryostat 归档位置 (使用 Cryostat 管理 JFR 记录)。
Example
以下示例显示一个自定义标签 reason=service-outage,除了三个默认记录标签, template.name=Profiling,template.type=TARGET, 和 autoanalyze=true 外。
图 4.11. 带有定义的记录标签和自定义标签的活跃记录示例
4.3.2. 为您的 JFR 记录编辑标签 复制链接链接已复制到粘贴板!
在 Cryostat web 控制台中,您可以进入 Flight Recorder > Capture > Recordings 菜单,然后编辑 JFR 记录的标签及其元数据。您还可以编辑上传到存档的 JFR 记录的标签和元数据。
先决条件
- 登录到您的 Cryostat web 控制台。
- 创建 JFR 记录和附加标签到此记录。
流程
- 在 Cryostat web 控制台中,点 Flight Recorder > Capture > Recordings 菜单。
- 在 Recordings 面板中,找到您的 JFR 记录,然后选中它旁边的复选框。
点击 Edit Labels。在 Cryostat web 控制台中打开 Edit labels 窗格,您可以使用它来为您的 JFR 记录添加、编辑或删除标签。
提示您可以选择每个记录旁边的复选框来选择多个 JFR 记录。如果要批量编辑包含相同标签的记录,或向多个记录添加新的相同的标签,点 Edit Labels 按钮。
图 4.12. 在 Recordings 面板中显示的 Edit labels 部分
可选 : 您可以从 Edit labels 窗格中执行以下操作:
- 单击 Add label 以创建标签。
-
点标签旁边的
x来删除标签。 - 通过修改字段中的任何内容来编辑标签。
- 点击 Save。
可选 :您可以通过完成以下步骤来归档您的 JFR 记录及其标签:
- 选中记录名称旁边的复选框。
点 归档 按钮。您可以在 Flight Recorder > Analyze > Archives 视图中找到您的记录。
使用标签归档记录,当您想要在以后的阶段找到记录时,您可以增强您的搜索功能。您还可以将额外标签添加到上传到 Cryostat 归档的任何记录中。
注意Cryostat 使用记录保留任何标签,以便进行存档记录的生命周期。
验证
- 在 Flight Recorder > Capture > Recordings 面板中,检查您的更改是否在您的记录的 Labels 列中显示。
更新于 2025-11-29