8.2. Lokistack のデプロイ

手順

1. Loki Operator Operator をインストールします。

   1. OpenShift Container Platform Web コンソールで、Operators OperatorHub をクリックします。
   2. 使用可能な Operator のリストから Loki Operator を選択し、Install をクリックします。
   3. Installation Mode で、All namespaces on the cluster を選択します。

   4. Installed Namespace で、openshift-operators-redhat を選択します。

      openshift-operators-redhat namespace を指定する必要があります。openshift-operators namespace には信頼されていないコミュニティー Operator が含まれる可能性があり、OpenShift Container Platform メトリックと同じ名前でメトリックを公開する可能性があるため、これによって競合が生じる可能性があります。

   5. Enable operator recommended cluster monitoring on this namespace を選択します。

      このオプションは、namespace オブジェクトに openshift.io/cluster-monitoring: "true" ラベルを設定します。クラスターモニタリングが openshift-operators-redhat namespace を収集できるように、このオプションを選択する必要があります。

   6. Approval Strategy を選択します。

      • Automatic ストラテジーにより、Operator Lifecycle Manager (OLM) は新規バージョンが利用可能になると Operator を自動的に更新できます。
      • Manual ストラテジーには、Operator の更新を承認するための適切な認証情報を持つユーザーが必要です。
   7. Install をクリックします。
   8. Loki Operator がインストールされていることを確認します。Operators→ Installed Operators ページにアクセスして、Loki Operator を探します。
   9. Loki Operator がすべてのプロジェクトで Succeeded の Status でリストされていることを確認します。

2. access_key_id フィールドと access_key_secret フィールドを使用して AWS 認証情報と bucketnames、endpoint、および region を指定し、オブジェクトストレージの場所を定義する Secret YAML ファイルを作成します。以下に例を示します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: logging-loki-s3
     namespace: openshift-logging
   stringData:
     access_key_id: AKIAIOSFODNN7EXAMPLE
     access_key_secret: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
     bucketnames: s3-bucket-name
     endpoint: https://s3.eu-central-1.amazonaws.com
     region: eu-central-1

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

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki
     namespace: openshift-logging
   spec:
     size: 1x.small
     storage:
       schemas:
       - version: v12
         effectiveDate: "2022-06-01"
       secret:
         name: logging-loki-s3
         type: s3
     storageClassName: gp2
     tenants:
       mode: openshift-logging

4. LokiStack CR を適用します。

   $ oc apply -f logging-loki.yaml

5. ClusterLogging カスタムリソース (CR) を作成します。

   apiVersion: logging.openshift.io/v1
   kind: ClusterLogging
   metadata:
     name: instance
     namespace: openshift-logging
   spec:
     managementState: Managed
     logStore:
       type: lokistack
       lokistack:
         name: logging-loki
     collection:
       type: vector

6. ClusterLogging CR を適用します。

   $ oc apply -f cr-lokistack.yaml

7. RedHat OpenShift ログコンソールプラグインを有効にします。

   1. OpenShift Container Platform Web コンソールで、Operators Installed Operators をクリックします。
   2. RedHat OpenShift Logging Operator を選択します。
   3. コンソールプラグインで 無効 をクリックします。
   4. 有効、保存 の順に選択します。この変更により、openshift-console Pod が再起動されます。
   5. Pod の再起動後、Web コンソールの更新が利用可能であるという通知を受け取り、更新するよう求められます。
   6. Web コンソールを更新したら、左側のメインメニューから 監視 をクリックします。Logs の新しいオプションが利用可能です。