2.3. 코어 설정 및 구성

프로세스

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

프로세스

1. 스트림 기반 보존을 활성화하려면 LokiStack CR을 생성하고 YAML 파일로 저장합니다. 다음 예제에서는 lokistack.yaml 이라고 합니다.

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

   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: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

   Copy to Clipboard Toggle word wrap

   1

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

   2

   CR에 retention 블록을 추가하여 클러스터에서 보존을 활성화합니다.

   3

   로그 스트림을 보존 규칙에 일치시킬 LogQL 쿼리 를 지정합니다.

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

   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: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

   Copy to Clipboard Toggle word wrap

   1

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

   2

   로그 스트림을 보존 규칙에 일치시킬 LogQL 쿼리 를 지정합니다.

2. LokiStack CR을 적용합니다.

   $ oc apply -f lokistack.yaml

   Copy to Clipboard Toggle word wrap