5.4. CLI を使用して ClusterLogging オブジェクトを作成する

手順

1. ClusterLogging オブジェクトを YAML ファイルとして作成します。

   ClusterLogging オブジェクトの例

   apiVersion: logging.openshift.io/v1
   kind: ClusterLogging
   metadata:
     name: instance 1
     namespace: openshift-logging
   spec:
     managementState: Managed 2
     logStore:
       type: elasticsearch 3
       retentionPolicy: 4
         application:
           maxAge: 1d
         infra:
           maxAge: 7d
         audit:
           maxAge: 7d
       elasticsearch:
         nodeCount: 3 5
         storage:
           storageClassName: <storage_class_name> 6
           size: 200G
         resources: 7
             limits:
               memory: 16Gi
             requests:
               memory: 16Gi
         proxy: 8
           resources:
             limits:
               memory: 256Mi
             requests:
               memory: 256Mi
         redundancyPolicy: SingleRedundancy
     visualization:
       type: kibana 9
       kibana:
         replicas: 1
     collection:
       type: fluentd 10
       fluentd: {}

   1

   名前は instance である必要があります。

   2

   OpenShift Logging の管理状態。OpenShift Logging のデフォルト値を変更する場合は、これを Unmanaged (管理外) に設定することが求められる場合があります。ただし、管理外のデプロイメントは OpenShift Logging がマネージドの状態に戻されるまで更新を受信しません。

   3

   Elasticsearch の設定に必要な設定。CR を使用してシャードのレプリケーションポリシーおよび永続ストレージを設定できます。

   4

   Elasticsearch が各ログソースを保持する期間を指定します。整数および時間の指定 (weeks(w)、hour(h/H)、minutes(m)、および seconds(s)) を入力します。たとえば、7 日の場合は 7d となります。maxAge よりも古いログは削除されます。各ログソースの保持ポリシーを指定する必要があります。指定しないと、Elasticsearch インデックスはそのソースに対して作成されません。

   5

   Elasticsearch ノードの数を指定します。このリストに続く注記を確認してください。

   6

   Elasticsearch ストレージの既存のストレージクラスの名前を入力します。最適なパフォーマンスを得るには、ブロックストレージを割り当てるストレージクラスを指定します。ストレージクラスを指定しないと、OpenShift Logging は一時ストレージを使用します。

   7

   必要に応じて CPU およびメモリー要求を指定します。これらの値を空のままにすると、OpenShift Elasticsearch Operator はデフォルト値を設定します。これらのデフォルト値はほとんどのデプロイメントでは問題なく使用できるはずです。デフォルト値は、メモリー要求の場合は 16Gi であり、CPU 要求の場合は 1 です。

   8

   必要に応じて Elasticsearch プロキシーの CPU およびメモリーの制限および要求を指定します。これらの値を空のままにすると、OpenShift Elasticsearch Operator はデフォルト値を設定します。これらのデフォルト値はほとんどのデプロイメントでは問題なく使用できるはずです。デフォルト値は、メモリー要求の場合は 256Mi、CPU 要求の場合は 100m です。

   9

   Kibana の設定に必要な設定。CR を使用して、冗長性を確保するために Kibana をスケーリングし、Kibana ノードの CPU およびメモリーを設定できます。詳細は、ログビジュアライザーの設定 を参照してください。

   10

   Fluentd の設定に必要な設定。CR を使用して Fluentd の CPU およびメモリー制限を設定できます。詳細は、「Fluentd の設定」を参照してください。

   注記

   Elasticsearch コントロールプレーンノードの最大数は 3 です。3 を超える nodeCount を指定する場合、OpenShift Container Platform は、マスター、クライアントおよびデータロールを使用して、3 つのマスターとしての適格性のあるノードである Elasticsearch ノードを作成します。追加の Elasticsearch ノードは、クライアントおよびデータロールを使用してデータ専用ノードとして作成されます。コントロールプレーンノードは、インデックスの作成および削除、シャードの割り当て、およびノードの追跡などのクラスター全体でのアクションを実行します。データノードはシャードを保持し、CRUD、検索、および集計などのデータ関連の操作を実行します。データ関連の操作は、I/O、メモリーおよび CPU 集約型の操作です。これらのリソースを監視し、現行ノードがオーバーロードする場合にデータノード追加することが重要です。

   たとえば、nodeCount=4 の場合に、以下のノードが作成されます。

   $ oc get deployment

   出力例

   NAME                           READY   UP-TO-DATE   AVAILABLE   AGE
   cluster-logging-operator       1/1     1            1           18h
   elasticsearch-cd-x6kdekli-1    1/1     1            1          6m54s
   elasticsearch-cdm-x6kdekli-1   1/1     1            1           18h
   elasticsearch-cdm-x6kdekli-2   1/1     1            1           6m49s
   elasticsearch-cdm-x6kdekli-3   1/1     1            1           6m44s

   インデックステンプレートのプライマリーシャードの数は Elasticsearch データノードの数と等しくなります。