OpenShift 로깅 정보

프로세스

1. OperatorHub에서 Red Hat OpenShift Logging Operator,Loki Operator 및 Cluster Observability Operator(COO) 를 설치합니다.

2. openshift-logging 네임스페이스에서 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: '2024-10-01'
         version: v13
       secret:
         name: logging-loki-s3
         type: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

   Copy to Clipboard Toggle word wrap
   참고

   logging-loki-s3 시크릿이 사전에 생성되었는지 확인합니다. 이 보안의 내용은 사용 중인 오브젝트 스토리지에 따라 다릅니다. 자세한 내용은 시크릿 및 TLS 구성을 참조하십시오.

3. 수집기의 서비스 계정을 생성합니다.

   $ oc create sa collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

4. 수집기의 서비스 계정에서 LokiStack CR에 데이터를 쓸 수 있도록 허용합니다.

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

   Copy to Clipboard Toggle word wrap
   참고

   ClusterRole 리소스는 Cluster Logging Operator 설치 중에 자동으로 생성되며 수동으로 생성할 필요가 없습니다.

5. 로그를 수집하려면 다음 명령을 실행하여 수집기의 서비스 계정을 사용합니다.

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
   참고

   이 예제에서는 수집기를 세 가지 역할(애플리케이션, 인프라 및 감사) 모두에 바인딩하지만 기본적으로 애플리케이션 및 인프라 로그만 수집됩니다. 감사 로그를 수집하려면 이를 포함하도록 ClusterLogForwarder 구성을 업데이트합니다. 환경에 필요한 특정 로그 유형에 따라 역할을 할당합니다.

6. UIPlugin CR을 생성하여 모니터링 탭의 Log 섹션을 활성화합니다.

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

   Copy to Clipboard Toggle word wrap

7. 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:
         authentication:
           token:
             from: serviceAccount
         target:
           name: logging-loki
           namespace: openshift-logging
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: default-logstore
       inputRefs:
       - application
       - infrastructure
       outputRefs:
       - default-lokistack

   Copy to Clipboard Toggle word wrap
   참고

   dataModel 필드는 선택 사항이며 설정되지 않은(dataModel: "") 기본적으로 유지됩니다. 이를 통해 Cluster Logging Operator(CLO)가 데이터 모델을 자동으로 선택할 수 있습니다. 현재 CLO는 필드가 설정되지 않은 경우 기본적으로 ViaQ 모델로 설정되지만 향후 릴리스에서는 변경될 예정입니다. dataModel: ViaQ 를 지정하면 기본 변경 사항이 있는 경우 구성이 계속 호환됩니다.

프로세스

1. OperatorHub에서 Red Hat OpenShift Logging Operator, Loki Operator 및 Cluster Observability Operator(COO)를 설치합니다.

2. openshift-logging 네임스페이스에서 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: '2024-10-01'
         version: v13
       secret:
         name: logging-loki-s3
         type: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

   Copy to Clipboard Toggle word wrap
   참고

   logging-loki-s3 시크릿이 사전에 생성되었는지 확인합니다. 이 보안의 내용은 사용 중인 오브젝트 스토리지에 따라 다릅니다. 자세한 내용은 "시크릿 및 TLS 구성"을 참조하십시오.

3. 수집기의 서비스 계정을 생성합니다.

   $ oc create sa collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

4. 수집기의 서비스 계정에서 LokiStack CR에 데이터를 쓸 수 있도록 허용합니다.

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

   Copy to Clipboard Toggle word wrap
   참고

   ClusterRole 리소스는 Cluster Logging Operator 설치 중에 자동으로 생성되며 수동으로 생성할 필요가 없습니다.

5. 수집기의 서비스 계정에서 로그를 수집할 수 있도록 허용합니다.

   $ oc project openshift-logging

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
   참고

   이 예제에서는 수집기를 세 가지 역할(애플리케이션, 인프라 및 감사) 모두에 바인딩합니다. 기본적으로 애플리케이션 및 인프라 로그만 수집됩니다. 감사 로그를 수집하려면 이를 포함하도록 ClusterLogForwarder 구성을 업데이트합니다. 환경에 필요한 특정 로그 유형에 따라 역할을 할당합니다.

6. UIPlugin CR을 생성하여 모니터링 탭의 Log 섹션을 활성화합니다.

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

   Copy to Clipboard Toggle word wrap

7. ClusterLogForwarder CR을 생성하여 로그 전달을 구성합니다.

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: collector
     namespace: openshift-logging
     annotations:
       observability.openshift.io/tech-preview-otlp-output: "enabled" 

   1

   
   spec:
     serviceAccount:
       name: collector
     outputs:
     - name: loki-otlp
       type: lokiStack 

   2

   
       lokiStack:
         target:
           name: logging-loki
           namespace: openshift-logging
         dataModel: Otel 

   3

   
         authentication:
           token:
             from: serviceAccount
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: my-pipeline
       inputRefs:
       - application
       - infrastructure
       outputRefs:
       - loki-otlp

   Copy to Clipboard Toggle word wrap

   1

   주석을 사용하여 기술 프리뷰 기능인 Otel 데이터 모델을 활성화합니다.

   2

   출력 유형을 lokiStack 으로 정의합니다.

   3

   OpenTelemetry 데이터 모델을 지정합니다.

   참고

   dataModel 이 Otel 인 경우 lokiStack.labelKeys 를 사용할 수 없습니다. dataModel 이 Otel 일 때 유사한 기능을 얻으려면 "OTLP 데이터 수집용 LokiStack 구성"을 참조하십시오.