1.5. 配置探测模板

流程

1. 使用您的首选文本编辑器创建 XML 配置文件。使用 JFR 事件信息填充文件，如应用程序上必须执行哪些事件 Cryostat。

   以下示例显示了包含 JFR 事件信息的自定义探测模板 XML 文件。当此文件上传到 Cryostat 时，Cryostat 可以将名为 Cryostat 代理插件 Demo Event 的自定义 JFR 事件添加到应用程序中。当 JMC 代理的 retrieveEventProbes 方法被调用时，Cryostat 会启动 JFR 事件。

   <jfragent>
       <!-- Global configuration options -->
       <config>
      	 <classprefix>__JFREvent</classprefix>
      	 <allowtostring>true</allowtostring>\
      	 <allowconverter>true</allowconverter>
       </config>
      	 <events>
      		 <event id="cryostat.demo.jfr.event9">
          		 <label>Cryostat Agent Plugin Demo Event</label>
          		 <description>Event for the agent plugin demo</description>
          		 <path>io/cryostat/demo/events</path>
          		 <stacktrace>true</stacktrace>
          		 <class>io.cryostat.core.agent.AgentJMXHelper</class>
          		 <method>
              		 <name>retrieveEventProbes</name>
      		 <descriptor>()Ljava/lang/String;</descriptor>
          		 </method>
           	<location>WRAP</location>
       	</event>
   	</events>
   </jfragent>

2. 通过在 CLI 中输入 oc login 命令登录到您的 Red Hat OpenShift Web 控制台。

3. 通过在 CLI 中输入以下命令，从探测模板规则创建 ConfigMap 资源。您必须在要部署 Cryostat 应用程序的路径中发出该命令。您可以使用此资源存储运行 Cryostat 实例的集群中的探测模板文件。

   使用 CLI 为探测模板创建 ConfigMap 资源示例

   $ oc create configmap <probe_template_name> --from-file=<path_to_custom_probe_template>

4. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。
   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

5. 在 Create Cryostat 面板中，要将 XML 格式的探测模板上传到资源中，请选择以下选项之一：

   1. 如果要使用 Form 视图：

      1. 点 Form view 单选按钮。
      2. 进入到 Cryostat 实例的 Probe Templates 部分。
      3. 在 Probe Templates 菜单中点 Add Probe Templates。在 Red Hat OpenShift 控制台中打开 Probe Templates 部分。

      4. 从 Config Map Name 下拉列表中选择包含探测模板的 ConfigMap 资源。

         图 1.6. Cryostat 实例的探测模板选项

         
      5. 在 Filename 字段中，输入 ConfigMap 中包含的 .xml 文件的名称。

   2. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 为 probeTemplates 属性指定任何自定义探测模板。此属性将 Cryostat Operator 指向您的 ConfigMap，以便 Operator 能够读取探测模板。

         为 probeTemplates 属性指定探测模板示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           ...
           probeTemplates:
             - configMapName: custom-probe1
               filename: my-probe-template1.xml
             - configMapName: custom-probe2
               filename: my-probe-template2.xml
         --

         重要

         您必须从 configMapName 下拉列表中选择与 Cryostat 或 Cluster Cryostat 实例关联的 ConfigMap 名称。另外，您必须在 filename 字段中指定与 ConfigMap 关联的密钥。

6. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
7. 如果要完成创建此 Cryostat 实例，请点击 Create。

验证

1. 在 Cryostat web 控制台中，从导航菜单中选择 Flight Recorder > Capture > Instrumentation。
2. 在 Probe Templates 选项卡中，检查您预加载探测模板是否显示在可用探测模板列表中。