使用 Cryostat 管理 JFR 记录

流程

1. 导航到 Recordings 菜单或您的 Cryostat 实例上的 Events 菜单。

   注意

   剩余的步骤使用 Recordings 菜单作为示例，但您可以按照 Events 菜单上的类似步骤操作。

2. 在 Recordings 面板中，从下拉列表中选择您的目标 JVM。如果您的目标 JVM 没有包含可信 SSL 证书，您将会收到提示，如下例所示：

   图 1.1. SSL 错误消息

   

3. 点 Security 按钮。在 Cryostat web 控制台中打开一个窗口，其中显示 Security 对话框。

   图 1.2. 安全对话框

   

4. 单击上传按钮。在 Cryostat Web 控制台中打开 Upload SSL 证书 窗口。

   图 1.3. 上传 SSL 证书窗口

   

5. 点 Browse 按钮并在本地系统中找到 SSL 证书。

   重要

   您的 SSL 证书必须以 二进制 或 base64 格式编码。Cryostat 支持 .der 和 .cer 文件扩展。

6. 重启您的 Cryostat 实例。
7. 导航到 Cryostat 实例上的 Recordings 菜单。
8. 如果在 web 控制台中看到 Authentication Required 消息提示，请输入您的凭证。有些目标 JVM 要求您进行身份验证，然后才能访问数据以进行审计。

流程

1. 点 Security 菜单项。

2. 从 Store Credentials 窗口中，单击 Add 按钮。此时会打开 Store Credentials 窗口。

   图 1.5. 存储凭证窗口示例

   

3. 在 Match Expression 字段中，指定匹配表达式详情。

   注意

   选择问号图标，在 Match Expression Hint 片段中查看推荐的语法。

4. 点击 Save。Store Credentials 窗口中会显示一个表条目，其中显示了目标 JVM 的 Match Expression。

   图 1.6. Store Credentials 窗格中的表条目示例

   
   重要

   为了安全起见，表条目不会显示您的用户名或密码。

5. 可选： 如果要删除目标 JVM 的存储凭证，您可以选中此目标 JVM 的表条目旁边的复选框，然后点 Delete。

流程

1. 在 Active Recordings 选项卡中，选中您的 JFR 记录的复选框。归档 按钮在 Active Recordings 工具栏中激活。

   图 2.1. 用于 JFR 记录的归档按钮

   

2. 单击 归档 按钮。Cryostat 为您的 JFR 记录创建存档记录。

   您可以从归档记录选项卡下查看存档记录以及与所选目标 JVM 相关的任何其他记录。

   另外，您还可以从 All Targets 表中查看存档的记录。

   图 2.2. 列在 All Targets 表中的目标 JVM 应用程序示例

   
   提示

   要删除没有归档记录的目标 JVM 条目，请选择 具有零记录复选框的 Hide 目标。

   在 JVM 目标条目旁边单击 twistie (v)后，您可以访问过滤器功能，您可以在其中编辑标签以增强过滤器或点击 Delete 按钮来删除过滤器。

3. 从 All Targets 表中，选中您要查看的每个目标 JVM 应用程序旁边的复选框。该表列出了每个存档的记录及其源位置。

4. 转至" 所有归档" 表。此表与 All Targets 表类似，但 All Archives 表从 Cryostat 中存档的文件中列出了目标 JVM 应用程序。

   注意

   如果存档的文件没有可识别的 JVM 应用，它仍然会在 All Archives 表中列出，但在标题 丢失的 嵌套表中打开。

5. 可选： 要删除存档的记录，选择特定归档 JFR 记录项旁边的复选框，然后在提示时点 Delete。

   图 2.3. 删除存档的 JFR 记录

   
   注意

   Cryostat 根据目标 JVM 应用程序的地址、活动记录的名称以及所创建归档记录的时间戳为存档记录分配存档记录。

流程

1. 导航到 Recordings 菜单或您的 Cryostat 实例的归档菜单。

   注意

   剩余的步骤使用 Recordings 菜单作为示例，但您可以按照归档菜单中的类似步骤操作。

2. 点 Active Recordings 选项卡或 归档 记录标签页来确定您想要的记录。

3. 找到列出的 JFR 记录，然后选择其溢出菜单。

   图 2.4. 查看 JFR 记录溢出菜单

   

4. 选择以下选项之一：

   1. 在 overflow 菜单中点 Download Recording。根据您配置操作系统的方式，将打开一个文件保存对话框。将 JFR 二进制文件和 JSON 文件保存到您的首选位置。
   2. 在 All Targets 表中，选择您列出的 JFR 记录的溢出菜单。点 Download 将存档的文件及其 JSON 文件保存，该文件中包含 metadata 和标签信息，并放在本地系统中。

5. 可选： 使用 Java Mission Control (JMC)桌面应用程序查看下载的文件。

   注意

   如果您不想下载 .jfr 文件，而是想要从 Cryostat 应用程序上的记录查看数据，您可以在 Grafana 选项中点 View。

流程

1. 进入 Cryostat 实例上的归档菜单。

   图 2.5. Cryostat web 控制台中的存档菜单

   

2. 可选： 在 Uploads 表中，您可以查看所有上传的 JFR 记录。Uploads 表还包含与其他表类似的过滤机制，如 All Targets 表和其他输出。您还可以使用归档菜单上的过滤机制来查找可能没有可识别的目标 JVM 应用的存档文件。

   图 2.6. 归档菜单中的 Uploads 表

   

3. 点上传图标。在 Cryostat web 控制台中打开 Re-Upload Archived Recording 窗口：

   图 2.7. Re-Upload Archived Recording 窗口

   
4. 在 JFR File 字段中，单击 Upload。

5. 找到 JFR 记录文件，这些文件是具有 .jfr 扩展名的文件，然后单击 Submit。

   注意

   或者，您可以将 .jfr 文件拖放到 JFR File 字段。

流程

1. 在 Cryostat 实例的 Dashboard 面板中，从下拉列表中选择 Target JVM。

2. 可选： 在 Topology 面板中，您可以通过选择 Add to view 图标来定义目标 JVM。选择图标后，会打开一个窗口来定义自定义目标连接 URL。

   1. 在 Connection URL 字段中输入 JVM 的 Java 管理扩展(JMX)端点的 URL。
   2. 可选： 在 Alias 字段中输入 JMX 服务 URL 的别名。

   3. 点 Create。

      图 3.1. 创建目标对话框

      

3. 在 Cryostat web 控制台的导航菜单中点 Events。Web 控制台中可能会打开一个身份验证所需的对话框。如有提示，在 Authentication Required 对话框中输入您的 Username 和 Password，然后点 Save 将您的凭证提供给目标 JVM。

   注意

   如果所选的目标 JMX 具有启用了 JMX 连接的 SSL 认证，您必须在提示时添加其证书。

   Cryostat 可以加密并存储目标 JVM 应用程序的凭证，该数据库中存储在 Red Hat OpenShift 上的持久性卷声明(PVC)上。

4. 在 Event Templates 选项卡下，找到列出的事件模板，然后选择其更多选项菜单。

5. 在更多选项菜单中点 Download。根据您配置操作系统的方式，将打开一个文件保存对话框。将文件保存到您的首选位置。

   图 3.2. 事件模板更多选项菜单的示例

   

6. 使用您的默认文件编辑器打开 文件，并编辑 文件以满足您的需要。您必须保存文件以保留配置更改。

   注意

   您可以在 描述 和供应商属性中添加值，以帮助在稍后的阶段识别您的文件。

7. 在 Events 菜单中，前往 Event Templates 选项卡，然后单击 Upload 图标。在 Cryostat web 控制台中打开 Create Custom Event Template 窗口。

   图 3.3. 创建自定义事件模板窗口

   
8. 点 Upload，并使用您的默认文件编辑器将一个或多个配置的事件模板文件上传到 Cryostat web 控制台。您还可以将文件拖放到 Template XML 窗口中。
9. 单击 Submit 按钮。Event Templates 标签页在您的 Cryostat web 控制台中打开，您现在可以查看自定义事件模板。

10. 可选： 创建事件模板后，您可以选择以下选项之一来使用模板创建 JFR 记录：

    • 从 Automated Rules 菜单，单击 Create，然后从 Template 列表中选择事件模板。
    • 在 Events 菜单中，找到列出的事件模板，然后从更多选项菜单中选择 Create Recording。
    • 在 Recordings 菜单的 Active Recordings 选项卡下，点 Create。

流程

1. 进入 Recordings 菜单或您的 Cryostat 实例的归档菜单。
2. 根据您的需要，点击 Active Recordings 选项卡或 归档 记录选项卡。

3. 找到您的 JFR 记录，然后选择 overflow 菜单。

   图 4.1. 可用于 JFR 记录示例的溢出菜单项

   
4. 在 overflow 菜单中点击 Grafana 选项中的 View。Grafana 应用程序将在新的 Web 浏览器窗口中打开。
5. 点 Grafana 仪表板中的登录图标。

6. 通过在终端中运行以下命令来确定您的凭据。

   <cryostat_name>=$(kubectl get cryostat -o jsonpath='{$.items[0].metadata.name}')
   
   oc get secret $<cryostat_name>-grafana-basic -o jsonpath='{$.data.GF_SECURITY_ADMIN_USER}' | base64 -d
   
   oc get secret $<cryostat_name>-grafana-basic -o jsonpath='{$.data.GF_SECURITY_ADMIN_PASSWORD}' | base64 -d

   您还可以在 Red Hat OpenShift 的 Cryostat 详情页面的 Grafana Secret 自定义资源(CR)中找到您的凭证。

   图 4.2. OpenShift 的 Cryostat 详情页面上的 Grafana Secret CR

   
7. 在 Grafana web 控制台登录页面中输入您的凭证。此时会打开仪表板窗口，并在各种时间序列图表中显示 JFR 记录的数据。

8. 可选： 通过在图表中选择时间序列片段来与图表交互。Grafana 扩展屏幕数据，只显示该时间间隔的数据。

   图 4.3. 带有绘制图形的 Grafana 仪表板示例