2.5. ロギングコレクターの設定

手順

1. ClusterLogForwarder CR を変更して、http レシーバー入力の設定を追加します。

   ClusterLogForwarder CR の例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
   # ...
   spec:
     inputs:
     - name: http-receiver 

   1

   
       type: receiver
       receiver:
         type: http 

   2

   
         port: 8443 

   3

   
         http:
           format: kubeAPIAudit 

   4

   
     outputs:
     - name: default-lokistack
       lokiStack:
         authentication:
           token:
             from: serviceAccount
         target:
           name: logging-loki
           namespace: openshift-logging
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
       type: lokiStack
   # ...
     pipelines: 

   5

   
       - name: http-pipeline
         inputRefs:
           - http-receiver
         outputRefs:
           - <output_name>
   # ...

   Copy to Clipboard Toggle word wrap

   1

   入力レシーバーの名前を指定します。

   2

   入力レシーバー型を http に指定します。

   3

   オプション: 入力レシーバーがリッスンするポートを指定します。これは、1024 から 65535 までの値とします。デフォルト値は 8443 です。

   4

   現在、HTTP 入力レシーバーでは kube-apiserver Webhook 形式のみがサポートされています。

   5

   入力レシーバーのパイプラインを設定します。

2. 次のコマンドを実行して、ClusterLogForwarder CR に変更を適用します。

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、コレクターが <clusterlogforwarder_resource_name>-<input_name> 形式の名前を持つサービスでリッスンしていることを確認します。

   $ oc get svc

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                      TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)            AGE
   collector                 ClusterIP   172.30.85.239    <none>        24231/TCP          3m6s
   collector-http-receiver   ClusterIP   172.30.205.160   <none>        8443/TCP           3m6s

   Copy to Clipboard Toggle word wrap

   この出力例では、サービス名は collector-http-receiver です。

2. 次のコマンドを実行して、認証局 (CA) 証明書ファイルを抽出します。

   $ oc extract cm/openshift-service-ca.crt -n <namespace>

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、curl コマンドを使用してログを送信します。

   $ curl --cacert <openshift_service_ca.crt> https://collector-http-receiver.<namespace>.svc:8443 -XPOST -d '{"<prefix>":"<msessage>"}'

   Copy to Clipboard Toggle word wrap

   <openshift_service_ca.crt> は、抽出した CA 証明書ファイルに置き換えます。

   注記

   検証手順に従うことによってのみ、クラスター内でログを転送できます。

手順

1. 次のコマンドを実行して、collect-infrastructure-logs クラスターのロールをサービスアカウントに付与します。

   バインドコマンドの例

   $ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z logcollector

   Copy to Clipboard Toggle word wrap

2. ClusterLogForwarder CR を変更して、syslog レシーバー入力の設定を追加します。

   ClusterLogForwarder CR の例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
   # ...
   spec:
     serviceAccount:
       name: <service_account_name>
     inputs:
       - name: syslog-receiver 

   1

   
         type: receiver
         receiver:
           type: syslog 

   2

   
           port: 10514 

   3

   
     outputs:
     - name: default-lokistack
       lokiStack:
         authentication:
           token:
             from: serviceAccount
         target:
           name: logging-loki
           namespace: openshift-logging
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
       type: lokiStack
   # ...
     pipelines: 

   4

   
       - name: syslog-pipeline
         inputRefs:
           - syslog-receiver
         outputRefs:
           - <output_name>
   # ...

   Copy to Clipboard Toggle word wrap

   1

   入力レシーバーの名前を指定します。

   2

   入力レシーバー型を syslog に指定します。

   3

   オプション: 入力レシーバーがリッスンするポートを指定します。これは、1024 から 65535 までの値とします。

   4

   入力レシーバーのパイプラインを設定します。

3. 次のコマンドを実行して、ClusterLogForwarder CR に変更を適用します。

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap