2.4. LokiStack을 사용하여 로그 저장

프로세스

1. AlertingRule 사용자 정의 리소스(CR)를 생성합니다.

   인프라 AlertingRule CR의 예

     apiVersion: loki.grafana.com/v1
     kind: AlertingRule
     metadata:
       name: loki-operator-alerts
       namespace: openshift-operators-redhat 1
       labels: 2
         openshift.io/<label_name>: "true"
     spec:
       tenantID: "infrastructure" 3
       groups:
         - name: LokiOperatorHighReconciliationError
           rules:
             - alert: HighPercentageError
               expr: | 4
                 sum(rate({kubernetes_namespace_name="openshift-operators-redhat", kubernetes_pod_name=~"loki-operator-controller-manager.*"} |= "error" [1m])) by (job)
                   /
                 sum(rate({kubernetes_namespace_name="openshift-operators-redhat", kubernetes_pod_name=~"loki-operator-controller-manager.*"}[1m])) by (job)
                   > 0.01
               for: 10s
               labels:
                 severity: critical 5
               annotations:
                 summary: High Loki Operator Reconciliation Errors 6
                 description: High Loki Operator Reconciliation Errors 7

   1

   이 AlertingRule CR이 생성되는 네임스페이스에는 LokiStack spec.rules.namespaceSelector 정의와 일치하는 레이블이 있어야 합니다.

   2

   labels 블록은 LokiStack spec.rules.selector 정의와 일치해야 합니다.

   3

   인프라 테넌트에 대한 AlertingRule CR은 openshift-*, kube-\* 또는 default 네임스페이스에서만 지원됩니다.

   4

   kubernetes_namespace_name: 의 값은 metadata.namespace 값과 일치해야 합니다.

   5

   이 필수 필드의 값은 중요,경고 또는 정보 여야 합니다.

   6

   이 필드는 필수입니다.

   7

   이 필드는 필수입니다.

   애플리케이션 AlertingRule CR의 예

     apiVersion: loki.grafana.com/v1
     kind: AlertingRule
     metadata:
       name: app-user-workload
       namespace: app-ns 1
       labels: 2
         openshift.io/<label_name>: "true"
     spec:
       tenantID: "application"
       groups:
         - name: AppUserWorkloadHighError
           rules:
             - alert:
               expr: | 3
                 sum(rate({kubernetes_namespace_name="app-ns", kubernetes_pod_name=~"podName.*"} |= "error" [1m])) by (job)
               for: 10s
               labels:
                 severity: critical 4
               annotations:
                 summary:  5
                 description:  6

   1

   이 AlertingRule CR이 생성되는 네임스페이스에는 LokiStack spec.rules.namespaceSelector 정의와 일치하는 레이블이 있어야 합니다.

   2

   labels 블록은 LokiStack spec.rules.selector 정의와 일치해야 합니다.

   3

   kubernetes_namespace_name: 의 값은 metadata.namespace 값과 일치해야 합니다.

   4

   이 필수 필드의 값은 중요,경고 또는 정보 여야 합니다.

   5

   이 필수 필드의 값은 규칙에 대한 요약입니다.

   6

   이 필수 필드의 값은 규칙에 대한 자세한 설명입니다.

2. AlertingRule CR을 적용합니다.

   $ oc apply -f <filename>.yaml

프로세스

1. LokiStack CR을 생성합니다.

   • 다음 예와 같이 스트림 기반 보존을 전역적으로 활성화합니다.

     AWS에 대한 글로벌 스트림 기반 보존의 예

     apiVersion: loki.grafana.com/v1
     kind: LokiStack
     metadata:
       name: logging-loki
       namespace: openshift-logging
     spec:
       limits:
        global: 1
           retention: 2
             days: 20
             streams:
             - days: 4
               priority: 1
               selector: '{kubernetes_namespace_name=~"test.+"}' 3
             - days: 1
               priority: 1
               selector: '{log_type="infrastructure"}'
       managementState: Managed
       replicationFactor: 1
       size: 1x.small
       storage:
         schemas:
         - effectiveDate: "2020-10-11"
           version: v13
         secret:
           name: logging-loki-s3
           type: aws
       storageClassName: gp3-csi
       tenants:
         mode: openshift-logging

     1

     모든 로그 스트림에 대한 보존 정책을 설정합니다. 참고: 이 필드는 오브젝트 스토리지에 저장된 로그의 보존 기간에는 영향을 미치지 않습니다.

     2

     이 블록이 CR에 추가되면 클러스터에서 보존이 활성화됩니다.

     3

     로그 스트림.spec: 제한을 정의하는 데 사용되는 LogQL 쿼리 를 포함합니다.

   • 다음 예와 같이 테넌트별로 스트림 기반 보존을 활성화합니다.

     AWS에 대한 테넌트별 스트림 기반 보존 예

     apiVersion: loki.grafana.com/v1
     kind: LokiStack
     metadata:
       name: logging-loki
       namespace: openshift-logging
     spec:
       limits:
         global:
           retention:
             days: 20
         tenants: 1
           application:
             retention:
               days: 1
               streams:
                 - days: 4
                   selector: '{kubernetes_namespace_name=~"test.+"}' 2
           infrastructure:
             retention:
               days: 5
               streams:
                 - days: 1
                   selector: '{kubernetes_namespace_name=~"openshift-cluster.+"}'
       managementState: Managed
       replicationFactor: 1
       size: 1x.small
       storage:
         schemas:
         - effectiveDate: "2020-10-11"
           version: v13
         secret:
           name: logging-loki-s3
           type: aws
       storageClassName: gp3-csi
       tenants:
         mode: openshift-logging

     1

     테넌트별 보존 정책을 설정합니다. 유효한 테넌트 유형은 애플리케이션,감사 및 인프라 입니다.

     2

     로그 스트림을 정의하는 데 사용되는 LogQL 쿼리 를 포함합니다.

2. LokiStack CR을 적용합니다.

   $ oc apply -f <filename>.yaml