第 3 章 事件模板
Cryostat 包括默认事件模板,可用于快速创建 JFR 记录来监控目标 JVM 的性能。
3.1. 使用自定义事件模板
在创建 JDK Flight Recorder (JFR)记录时,您可以选择以下默认事件模板之一:
- 持续模板,它将在固定持续时间或明确停止之前收集基本目标 Java 虚拟机(JVM)数据。
- 分析模板,在固定持续时间或明确停止之前收集深入的目标 JVM 数据。
通过使用这些默认事件模板,您可以快速创建 JFR 记录来监控目标 JVM 的性能。您可以在稍后的阶段中编辑任一事件模板以满足您的需要。例如,默认事件模板不包含特定于应用程序的自定义事件,因此您必须将这些自定义事件添加到自定义模板中。
Cryostat 还支持 ALL
meta-template,它允许 JFR 监控目标 JVM 的所有事件类型。每种事件类型都存在默认值。ALL
meta-template 不包含 XML 定义,因此您无法下载 ALL
meta-template 的 XML 文件。
前提条件
- 使用 Installed Operators 选项在 Red Hat OpenShift 上安装 Cryostat 2.4。
- 在 Red Hat OpenShift 项目中创建一个 Cryostat 实例。
流程
- 在 Cryostat 实例的 Dashboard 面板中,从下拉列表中选择 Target JVM。
可选: 在 Topology 面板中,您可以通过选择 Add to view 图标来定义目标 JVM。选择图标后,会打开一个窗口来定义自定义目标连接 URL。
- 在 Connection URL 字段中输入 JVM 的 Java 管理扩展(JMX)端点的 URL。
- 可选: 在 Alias 字段中输入 JMX 服务 URL 的别名。
点 Create。
图 3.1. 创建目标对话框
在 Cryostat web 控制台的导航菜单中点 Events。Web 控制台中可能会打开一个身份验证所需的对话框。如有提示,在 Authentication Required 对话框中输入您的 Username 和 Password,然后点 Save 将您的凭证提供给目标 JVM。
注意如果所选的目标 JMX 具有启用了 JMX 连接的 SSL 认证,您必须在提示时添加其证书。
Cryostat 可以加密并存储目标 JVM 应用程序的凭证,该数据库中存储在 Red Hat OpenShift 上的持久性卷声明(PVC)上。
- 在 Event Templates 选项卡下,找到列出的事件模板,然后选择其更多选项菜单。
在更多选项菜单中点 Download。根据您配置操作系统的方式,将打开一个文件保存对话框。将文件保存到您的首选位置。
图 3.2. 事件模板更多选项菜单的示例
使用您的默认文件编辑器打开 文件,并编辑 文件以满足您的需要。您必须保存文件以保留配置更改。
注意您可以在
描述
和供应商属性中添加值,以帮助在稍后的阶段识别您的文件。在 Events 菜单中,前往 Event Templates 选项卡,然后单击 Upload 图标。在 Cryostat web 控制台中打开 Create Custom Event Template 窗口。
图 3.3. 创建自定义事件模板窗口
- 点 Upload,并使用您的默认文件编辑器将一个或多个配置的事件模板文件上传到 Cryostat web 控制台。您还可以将文件拖放到 Template XML 窗口中。
- 单击 Submit 按钮。Event Templates 标签页在您的 Cryostat web 控制台中打开,您现在可以查看自定义事件模板。
可选: 创建事件模板后,您可以选择以下选项之一来使用模板创建 JFR 记录:
- 从 Automated Rules 菜单,单击 Create,然后从 Template 列表中选择事件模板。
- 在 Events 菜单中,找到列出的事件模板,然后从更多选项菜单中选择 Create Recording。
- 在 Recordings 菜单的 Active Recordings 选项卡下,点 Create。
其他资源
- 请参阅创建 JDK Flight Recorder (JFR)记录 (使用 Cryostat 创建 JFR 记录)
- 请参阅 上传 SSL 证书 (使用 Cryostat 管理 JFR 记录)
- 请参阅 Archiving JDK Flight Recorder (JFR)记录 (使用 Cryostat 来管理 JFR 记录)
- 请参阅 启用或禁用自动规则(使用 Cryostat 自动规则)