第 2 章 新功能
Cryostat 2.1 引入了一项新功能,可以增强您的使用 Cryostat 产品。
自动规则用户控制台(UI)
Cryostat 2.1 包含用于自动化规则 API 的用户控制台(UI)。UI 包括以下主要功能:
- 通过支持输入输入来简化用户与 API 交互的表单视图。
- 匹配表达式向导,您可以创建针对特定应用程序的自定义匹配表达式。
- 所选目标应用程序的 JSON 格式视图,以便您可以查看高级应用程序信息。此信息形成了创建匹配表达式的完整组成部分。
- 一个颜色编码的响应系统,指明您的表达式是否与所选目标应用程序匹配。
match 表达式向导包含一个自定义匹配表达式的示例,如果您需要熟悉自定义匹配表达式语法,可以引用该表达式。
将元数据和标签附加到 JFR 记录
当您在 Cryostat 2.1 上创建 JFR 记录时,您可以在记录中添加带有键值对的元数据。另外,您可以将自定义标签附加到目标 JVM 内的 JFR 记录中,以便您可以轻松识别和更好地管理您的 JFR 记录。
元数据和标签的用例包括在记录时运行查询或批处理操作。您可以导航到 Cryostat web 控制台中的 Recordings 菜单,并编辑 JFR 记录中的标签及其元数据。您还可以编辑上传到存档的 JFR 记录的标签和元数据。
对客户端通知的控制
Cryostat 2.1 广播可以进行的所有操作和状态更改的通知,从而导致 Cryostat Web 客户端中出现更多数量的通知。因此,Settings 页面可以控制客户端通知。
Cryostat 2.1 用户可以通过类别和批量启用或禁用所有图形通知。
Cryostat 后端仍然发送通知信息,Web 客户端接收它们。禁用通知可防止在控制台中显示消息。再次启用通知,您可以阅读前面的任何通知。
自定义资源定义
现在,您可以为 Cryostat 实例创建一个自定义资源定义。这允许 Cryostat Operator 使用除 Cryostat 默认协议以外的 JMX 协议连接目标应用程序。默认协议通常是 JMX-RMI。
自定义资源定义由一个 YAML 文件组成,您可以在其中为定义指定以下任何属性:
-
alias,用于为资源定义设置可选名称。 -
注解.cryostat,定义的可选注解。自动规则可使用这些注解将规则应用到目标 JVM。 -
connectUrl指定目标 URL,如 JMX 服务 URL 或host:port对,在打开到目标 JVM 应用程序的 JMX 连接时,C Cryostat 必须使用它。这个属性是必须的。
当您创建自定义目标对象时,C Cryostat Operator 会为对象使用 RESTful API 端点 POST /api/v2/targets。创建对象后,对象的 connectUrl 可用作 REST HTTP API 中的 targetId URL 参数。
您可以使用 TargetDeleteHandler 从 Cryostat Operator 中删除自定义资源定义。此处理程序读取 DELETE /api/v2/targets/:connectUrl 端点请求,并尝试从 Cryostat Operator 中删除定义。
TargetsPostHandler 和 TargetDeleteHandler 包括代码的错误消息,如果处理程序无法处理请求,则会提供详细的错误消息。
Cryostat Operator 的环境变量
Cryostat 2.1 包括以下环境变量,您可以将其设置为更改 Cryostat Operator 的行为:
-
CRYOSTAT_REPORT_GENERATION_MAX_HEAP: Defaults to200MiB。设置容器子进程使用的最大堆大小来生成自动化规则分析报告。 -
CRYOSTAT_MAX_WS_CONNECTIONS: Defaults tounlimited。设置您的 Cryostat 应用程序支持的最大 WebSocket 客户端连接数。 -
CRYOSTAT_TARGET_CACHE_SIZE: 默认为-1,它表示一个无限缓存。设置 OpenShift Operator 可以缓存至 Cryostat 应用程序的最大 JMX 连接数。 -
CRYOSTAT_TARGET_CACHE_TTL:默认为10,表示 JMX 连接在您的 Cryostat 实例内存中缓存的时间(以秒为单位)。
JMC Agent 插件支持
Cryostat 2.1 支持 JMC Agent 插件,通过使用一组 API 处理程序来管理探测模板。
安装 JMC Agent 应用程序并将其构建后生成 JAR 文件,您可以使用 JMC Agent 插件访问 Cryostat 应用程序的代理功能。此插件为您的 Cryostat 实例提供 JMC Agent 功能,如将 JDK Flight Recorder (JFR)功能添加到正在运行的应用程序。
Red Hat OpenShift 身份验证 for Cryostat 2.1
Cryostat 2.1 将 Red Hat OpenShift 内置的 OAuth 服务器集成到其框架中。启用后,用户可以使用其 Red Hat OpenShift 用户名和密码登录到 Cryostat。此集成功能提供了比在 Cryostat 2.0 中提供的一个更好的机制,您必须从 Red Hat OpenShift Web 控制台手动复制 Red Hat OpenShift 授权令牌,然后在控制台的 Cryostat 应用程序 URL 部分中粘贴令牌详情。
另外,您可以使用 Red Hat OpenShift 中分配的基于角色的访问控制(RBAC)角色限制对 Cryostat 功能的访问。
Cryostat 2.1 发行版本包括 GET /health 响应对象的以下密钥:
-
DATASOURCE_CONFIGURED -
DASHBOARD_CONFIGURED -
REPORTS_CONFIGURED -
REPORTS_AVAILABLE
Red Hat OpenShift 凭证
从 Red Hat OpenShift Web 控制台登录到 Cryostat 2.1 web 控制台后,Cryostat Operator 会在会话期间在 Red Hat OpenShift 帐户中临时将用户名和密码凭证存储在 Red Hat OpenShift 帐户中。这可防止您的 Cryostat web 控制台会话在登出 Cryostat web 控制台前结束。
在 Cryostat 2.1 中管理 Java 管理扩展凭证
您可以存储和管理用于在容器化 Java 虚拟机(JVM)身份验证的 Java 管理扩展(JMX)凭证。当您希望 Cryostat 记住并重复使用多个 JVM 的凭证时,此功能很有用。
将 JMX 凭证添加到 Cryostat 时,您无法再查看凭证。这会保持凭证安全,因为在在 Cryostat web 控制台中输入凭证后,您的凭证不会保持可见。如果要替换凭证,必须删除凭证并再次添加凭证。
新的自动化规则环境变量
在 Cryostat 2.1 之前,如果这些 JMX 连接之前被缓存到您的 Cryostat 实例的内存,则自动化规则的 JMX 连接将关闭。出现这个问题的原因是 CRYOSTAT_TARGET_CACHE_MAX_CONNECTIONS 环境变量的行为。
Cryostat 2.1 的 JMX 缓存组件现在使用 CRYOSTAT_TARGET_CACHE_SIZE _SIZE 环境变量,而不是 CRYOSTAT_TARGET_CACHE_MAX_CONNECTIONS 环境变量。这意味着,您打开的任何 JMX 连接都不会通过将规则自动缓存到您的 Cryostat 实例内存。这可防止自动规则填充缓存存储空间,并导致使用 JMX 连接关闭,这可能会导致性能下降并响应时间。
CRYOSTAT_TARGET_CACHE_SIZE 环境变量指定您的 Cryostat 实例内存中缓存的最大 JMX 连接数。您可以为这个环境变量指定以下值:
-
< 0:默认值为
-1。值小于0表示一个无限的缓存大小。这意味着,JMX 连接只有在达到不活跃限制时才能从内存中删除。 - 0:当这些连接关闭时,值为 0 表示会立即从内存中删除 JMX 连接。
-
>
0: value 大于 0 表示 Cryostat 实例可以在其内存中缓存一组 JMX 连接。如果在缓存数量达到其级别时创建新的连接,则最旧的 JMX 连接将关闭并从内存中删除以促进新连接的存储。
自动规则可以重新使用任何之前缓存的 JMX 连接。如果没有 JMX 连接,则 Cryostat Operator 会为自动规则创建新的 JMX 连接。这个连接不会缓存到内存。
资源要求
默认情况下,Cryostat Operator 会部署 Cryostat 应用程序,而无需为 Cryostat 实例的主 pod 在 Red Hat OpenShift 上运行的三个容器指定任何资源请求或限制。Cryostat 2.1 包含一个功能,您可以使用 Cryostat 自定义资源(CR)为以下三个容器指定资源请求或限值:
-
核心,用于运行 Cryostat 后端服务和 Web 应用程序。 -
数据源,运行 JFR 数据源,可将您的 JFR 记录转换为 Grafana 支持的文件格式。 -
Grafana,用于运行与您的 Cryostat 应用程序关联的 Grafana 实例。
Sidecar 报告容器
在 Cryostat 2.1 中,您可以使用 sidecar 报告容器为 JDK flight 记录(JFR)生成自动分析报告。
在 Cryostat 2.1 之前,您必须依赖主 Cryostat 容器来生成分析报告。这个方法非常大,可能会影响到运行 Cryostat 应用程序的性能,因为您可能需要为主 Cryostat 容器置备其他资源。
通过在 sidecar 报告容器中生成分析报告,您可以有效地使用 Cryostat Operator 来为您的 Cryostat 应用程序置备资源。这为您的 Cryostat 容器提供了较低的资源空间,因为与容器交互的 Cryostat Operator 可以专注于通过 HTTP 和 JMC 连接运行低元操作。
另外,您可以重复 sidecar 报告容器,然后配置这个重复以满足您的需要。