搜索

1.4. 自定义事件模板

download PDF

在 Cryostat 2 中,您可以配置 Cryostat Operator YAML 配置文件的 eventTemplates 属性,使其包含多个自定义模板。事件模板概述了 JDK Flight Recording (JFR)的事件记录标准。您可以通过其关联的事件模板配置 JFR。

默认情况下,C Cryostat Operator 包含一些预先配置的事件模板。这些预先配置的事件模板可能无法满足您的需要,因此您可以使用 Cryostat Operator 为 Cryostat 实例生成自定义事件模板,并将这些模板存储在 ConfigMap 中以方便检索。您可以使用以下方法生成自定义事件模板:

  • 使用 OpenShift Web 控制台将事件模板上传到自定义资源中。
  • 在 OpenShift Web 控制台中编辑 Cryostat 自定义资源的 YAML 文件。

ConfigMap 中存储自定义事件模板后,您可以使用此自定义事件模板部署一个新的 Cryostat 实例。然后,您可以将自定义事件模板与 JFR 一起使用,以监控 Java 应用程序以满足您的需要。

前提条件

  • 使用 OpenShift Web 控制台登录到 OpenShift Container Platform。
  • 在项目中创建 Cryostat 实例。
  • 登录到您的 Cryostat web 控制台。

流程

  1. 要下载默认事件模板,请导航到 Cryostat Web 控制台和 Events 菜单,点 Downloads

    注意

    事件模板采用 XML 格式,文件名扩展名为 .jfc

  2. 可选: 如果您希望自定义事件模板,使用文本编辑器或 XML 编辑器编辑下载的默认事件模板,以配置模板以满足您的需要。
  3. 在 CLI 中输入 oc login 命令,登录到您的 OpenShift Web 控制台。
  4. 在 CLI 中输入以下命令,从事件模板创建 ConfigMap 资源。您必须在要部署 Cryostat 应用程序的路径中发出 命令。您可以使用此资源存储运行 Cryostat 实例的集群中的事件模板文件。

    使用 CLI 创建 ConfigMap 资源示例

    $ oc create configmap <template_name> --from-file=<path_to_custom_event_template>

  5. 在 OpenShift Web 控制台中,点 Operators > Installed Operators
  6. 从可用 operator 列表中选择 Cryostat Operator
  7. Provided APIs 菜单下的 Create instance
  8. 选择以下选项之一将 XML 格式的事件模板上传到资源中:

    1. Form view 单选按钮。

      1. 导航到 Cryostat 实例的 Event Templates 部分。
      2. Event Templates 菜单中点 Add Event Template。在 OpenShift 控制台中打开 Event Templates 部分。
      3. Config Map Name 下拉列表中,选择包含事件模板的 ConfigMap 资源。

        图 1.4. Cryostat 实例的事件模板选项

        Cryostat 实例的事件模板选项
      4. Filename 字段中输入 ConfigMap 中包含的 .jfc 文件的名称。
      5. Create 按钮生成带有自定义事件模板的 Cryostat 实例。
    2. 点击 YAML 视图 单选按钮。

      1. eventTemplates 属性指定任何自定义事件模板。此属性将 Cryostat Operator 指向 ConfigMap,以便 Cryostat Operator 可以读取事件模板。

        eventTemplates 属性指定自定义事件模板示例

        --
        apiVersion: operator.cryostat.io/v1beta1
        kind: Cryostat
        metadata:
          name: cryostat-sample
        spec:
          eventTemplates:
          - configMapName: custom-template1
            filename: my-template1.jfc
          - configMapName: custom-template2
            filename: my-template2.jfc
        --

        重要

        您必须从 configMapName 下拉列表中选择与 Cryostat 实例关联的 ConfigMap 名称。另外,您必须在 filename 字段中指定一个与 ConfigMap 关联的键。

        Cryostat Operator 现在可将自定义事件模板作为 XML 文件提供给您的 Cryostat 应用程序。您的自定义事件模板会在 Cryostat web 控制台中与默认事件模板一起打开。

验证

  1. 在 Cryostat Web 控制台中,从菜单中点击 Events。如果 web 控制台中打开 Authentication Required 窗口,请输入您的凭证并点 Save
  2. Event Templates 选项卡中,检查您的自定义事件模板是否显示在可用事件模板列表中。

    图 1.5. Event Templates 选项卡下列出的自定义事件模板示例

    Event Templates 选项卡下列出的自定义事件模板示例

其他资源

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.