4.5.4.3. OpenShift CLI から Insights Operator を使用してオンデマンドでデータを収集する

手順

1. 次の DataGather 仕様を含む YAML ファイルを作成します。

   apiVersion: insights.openshift.io/v1alpha2
   kind: DataGather
   metadata:
     name: <your_data_gather>
   spec:
   # Gatherers configuration
     gatherers:
       mode: All # Options: All, Custom
   # ...

   重要
   • 収集操作に指定する名前 <your_data_gather> は、一意である必要があり、periodic-gathering- という接頭辞を含むことはできません。この文字列は他の管理操作用に予約されており、目的の収集操作に影響を与える可能性があるためです。
   • DataGather CRD の spec が定義されていない場合は、デフォルトの Insights Operator データ収集ジョブが実行されます。つまり、すべての収集操作が実行され、収集されたデータは難読化されず、アーカイブファイルは保持されません。

2. オプション: データ収集操作をカスタマイズするには、DataGather YAML ファイルで次のオプションを設定できます。

   • 特定の gatherer を無効にするには、mode の値を Custom に変更し、無効にする個々の gatherer を指定します。たとえば、ワークロードの gatherer を無効にするには、次の例を追加します。

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
         # Gatherers configuration
       gatherers:
         mode: Custom  # Options: All, Custom
         custom:
           configs:
             # Essential cluster configuration gatherers
             - name: clusterconfig/authentication
               state: Enabled
             - name: clusterconfig/clusteroperators
               state: Enabled
             - name: workloads
               state: Disabled

   • 永続ストレージで直近 10 件までのデータ収集ジョブのデータアーカイブファイルと履歴を保持できるようにするには、storage 仕様を定義します。次の例に示すように、type を PersistentVolume に設定し、ボリュームの mountPath と name を定義します。

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       storage:
         type: PersistentVolume
         mountPath: /data
         persistentVolume:
           claim:
             name: on-demand-gather-pvc

     重要

     指定したボリューム名が、openshift-insights namespace 内の既存の PersistentVolumeClaim 値と一致していることを確認してください。詳細は、永続ボリューム要求 を参照してください。

   • データの難読化を有効にするには、dataPolicy キーと必要な値を定義します。たとえば、IP アドレスとワークロード名を難読化するには、次の設定を追加します。

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       dataPolicy:
         - ObfuscateNetworking
         - WorkloadNames

3. OpenShift Container Platform CLI で、次のコマンドを入力して収集操作を実行します。

   $ oc apply -f <your_data_gather_definition>.yaml