搜索

4.3. JFR 记录的标签

download PDF

当您在 Cryostat 3.0 上创建 JDK Flight Recorder (JFR)记录时,您可以通过指定一系列键值对在记录中添加元数据。

另外,您可以将自定义标签附加到目标 JVM 内部的 JFR 记录,以便您可以轻松识别和更好地管理 JFR 记录。

以下列表详细介绍了一些常见记录标签用例:

  • 将元数据附加到您的 JFR 记录。
  • 在包含相同标签的记录上执行批处理操作。
  • 在记录上运行查询时使用标签。

您可以使用 Cryostat 创建监控容器化应用程序中 JVM 性能的 JFR 记录。另外,您可以为目标 JVM 应用程序生成活跃的 JFR 记录的快照,以捕获任何收集的数据(最多指向特定时间)。

4.3.1. 在 JFR 记录中添加标签

在 Cryostat 3.0 上创建 JFR 记录时,您可以使用标签将包含键值对的元数据添加到记录中。

Cryostat 将默认记录标签应用到创建的 JFR 记录。这些默认标签捕获 Cryostat 用于创建 JFR 记录的事件模板的信息。

您可以在 JFR 记录中添加自定义标签,以便您可以运行满足您的需要的特定查询,如识别特定的 JFR 记录或在具有相同应用标签的记录上执行批处理操作。

先决条件

  • 登录到您的 Cryostat web 控制台。
  • 为您的 Cryostat 实例创建或选择目标 JVM。

流程

  1. 在 Cryostat web 控制台中点 Recordings
  2. Active Recordings 选项卡下,点 Create
  3. Custom Flight Recording 选项卡中,展开 Show metadata options

    注意

    Custom Flight Recording 选项卡中,您必须完成所有标记为星号的强制字段。

  4. Add label

    图 4.10. Custom Flight Recording 选项卡下显示的 Add Label 按钮

    在 *Custom Flight Recording* 标签页中显示的 *Add Label* 按钮
  5. 在提供的 KeyValue 字段中输入值。例如,如果要在 Key 字段中输入问题,可以在 Key 字段中输入问题,然后在 Value 字段中输入问题类型。
  6. Create 创建您的 JFR 记录。然后,您的记录会在 Active Recordings 选项卡中显示,以及任何指定的记录标签和自定义标签。

    提示

    您可以从 Archives 菜单访问归档的 JFR 记录。请参阅 将 JFR 记录上传到 Cryostat 归档位置 (使用 Cryostat 管理 JFR 记录)。

Example

以下示例显示了两个默认记录标签 template.name: Profiling and template.type: TARGET,以及一个自定义标签 reason:service-outage

图 4.11. 带有定义的记录标签和自定义标签的活跃记录示例

带有定义的记录标签和自定义标签的活跃记录示例

4.3.2. 为您的 JFR 记录编辑标签

在 Cryostat web 控制台中,您可以进入 Recordings 菜单,然后编辑 JFR 记录的标签及其元数据。您还可以编辑上传到存档的 JFR 记录的标签和元数据。

先决条件

  • 登录到您的 Cryostat web 控制台。
  • 创建 JFR 记录并将标签附加到此记录。

流程

  1. 在 Cryostat web 控制台中,点 Recording 菜单。
  2. Active Recordings 选项卡中,找到您的 JFR 记录,然后选中它旁边的复选框。
  3. 点击 Edit Labels。在 Cryostat web 控制台中打开 Edit Recording Label 窗格,可用于为 JFR 记录添加、编辑或删除标签。

    提示

    您可以选择每个记录旁边的复选框来选择多个 JFR 记录。如果要批量编辑包含相同标签的记录,或向多个记录添加新的相同的标签,点 Edit Labels 按钮。

  4. 可选 : 您可以从 Edit Recording Labels 窗格中执行以下操作:

    1. 单击 Add 以创建标签。
    2. 点标签旁边的 X 来删除标签。
    3. 通过修改字段中的任何内容来编辑标签。编辑内容后,字段中会显示一个绿色勾号来指示编辑。
  5. 点击 Save
  6. 可选 :您可以通过完成以下步骤来归档您的 JFR 记录及其标签:

    1. 选中记录名称旁边的复选框。
    2. 归档 按钮。您可以在 Archived Recordings 选项卡下找到您的记录。

      使用标签归档记录,当您想要在以后的阶段找到记录时,您可以增强您的搜索功能。您还可以将额外标签添加到上传到 Cryostat 归档的任何记录中。

      注意

      Cryostat 使用记录保留任何标签,以便进行存档记录的生命周期。

验证

  • Active Recordings 选项卡中,检查您的更改是否显示在 Labels 部分以了解您的记录。

更新于 2024-07-02

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.