1.4. 自動化ルールのカスタマイズ

手順

1. デフォルトの自動化ルールをダウンロードするには、Cryostat Web コンソールに移動し、Flight Recorder > Capture > Automated Rules を選択します。次に、ダウンロードするルールの横にあるオーバーフローアイコンをクリックし、Download をクリックします。

   注記

   自動化ルールは JSON 形式であり、ファイル名拡張子は .json です。

2. カスタム自動化ルールを作成するには、テキストエディターを使用してダウンロードした自動化ルールファイルを編集し、ニーズに合わせてルール定義を設定します。

   たとえば、デフォルトの continuous_analysis.json 自動化ルールファイルには、次の詳細が含まれています。

   {"name":"continuous_analysis","description":"","matchExpression":"true","eventSpecifier":"template=Continuous,type=TARGET","archivalPeriodSeconds":300,"initialDelaySeconds":0,"preservedArchives":1,"maxAgeSeconds":600,"maxSizeBytes":0,"metadata":{"labels":[{"key":"origin","value":"automated-analysis"},{"key":"autoanalyze","value":"true"}]},"enabled":false}

3. CLI で oc login コマンドを入力して、Red Hat OpenShift Web コンソールにログインします。

4. CLI で次のコマンドを入力して、自動化ルールから ConfigMap リソースを作成します。Cryostat アプリケーションをデプロイするパスでコマンドを実行する必要があります。このリソースを使用して、Cryostat インスタンスを実行するクラスター内にある自動化ルールファイルを保存できます。

   CLI を使用して自動化ルールの ConfigMap リソースを作成する例

   $ oc create configmap <automated_rule_name> --from-file=<path_to_custom_automated_rule>

5. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

6. Create Cryostat パネルで、JSON 形式の自動化ルールをリソースにアップロードするには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。
      2. Cryostat インスタンスの Automated Rules セクションに移動します。
      3. Automated Rules メニューから、Add Automated Rules をクリックします。Red Hat OpenShift コンソールで Automated Rules セクションが開きます。

      4. Config Map Name ドロップダウンリストから、自動化ルールが含まれている ConfigMap リソースを選択します。

         図1.5 Cryostat インスタンスの Automated Rules オプション

         
      5. Filename フィールドに、ConfigMap に含まれている .json ファイルの名前を入力します。

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. automatedRules プロパティーにカスタム自動化ルールを指定します。これは、Cryostat Operator が ConfigMap を指し示すようにするプロパティーで、これにより、Operator は自動化ルールを読み取ることができます。

         automatedRules プロパティーにカスタム自動化ルールを指定する例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           ...
           automatedRules:
           - configMapName: custom-rule1
             filename: my-rule1.json
           - configMapName: custom-rule2
             filename: my-rule2.json
         --

         重要

         configMapName ドロップダウンリストから、Cryostat または Cluster Cryostat インスタンスに関連付けられている ConfigMap の名前を選択する必要があります。さらに、filename フィールドに ConfigMap に関連付けられたキーを指定する必要があります。

7. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
8. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

検証

1. Cryostat Web コンソールで、ナビゲーションメニューから Flight Recorder > Capture > Automated Rules を選択します。
2. Automated Rules パネルで、利用可能な自動化ルールのリストにカスタム自動化ルールが表示されているか確認します。