第4章 クイックスタート

手順

1. OperatorHub から Red Hat OpenShift Logging Operator、Loki Operator、および Cluster Observability Operator (COO) をインストールします。

2. 既存のオブジェクトストレージバケットにアクセスするためのシークレットを作成します。

   AWS のコマンド例

   $ oc create secret generic logging-loki-s3 \
     --from-literal=bucketnames="<bucket_name>" \
     --from-literal=endpoint="<aws_bucket_endpoint>" \
     --from-literal=access_key_id="<aws_access_key_id>" \
     --from-literal=access_key_secret="<aws_access_key_secret>" \
     --from-literal=region="<aws_region_of_your_bucket>" \
     -n openshift-logging

3. openshift-logging namespace に LokiStack カスタムリソース (CR) を作成します。

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki
     namespace: openshift-logging
   spec:
     managementState: Managed
     size: 1x.extra-small
     storage:
       schemas:
       - effectiveDate: '2022-06-01'
         version: v13
       secret:
         name: logging-loki-s3
         type: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

4. コレクターのサービスアカウントを作成します。

   $ oc create sa collector -n openshift-logging

5. ClusterRole をサービスアカウントにバインドします。

   $ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector -n openshift-logging

6. Observe タブの Log セクションを有効にするには、UIPlugin を作成します。

   apiVersion: observability.openshift.io/v1alpha1
   kind: UIPlugin
   metadata:
     name: logging
   spec:
     type: Logging
     logging:
       lokiStack:
         name: logging-loki

7. コレクターサービスアカウントにロールを追加します。

   $ oc adm policy add-cluster-role-to-user collect-application-logs -z collector -n openshift-logging

   $ oc adm policy add-cluster-role-to-user collect-audit-logs -z collector -n openshift-logging

   $ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector -n openshift-logging

8. ClusterLogForwarder CR を作成して、ログ転送を設定します。

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: collector
     namespace: openshift-logging
   spec:
     serviceAccount:
       name: collector
     outputs:
     - name: default-lokistack
       type: lokiStack
       lokiStack:
         target:
           name: logging-loki
           namespace: openshift-logging
         authentication:
           token:
             from: serviceAccount
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: default-logstore
       inputRefs:
       - application
       - infrastructure
       outputRefs:
       - default-lokistack