5.2. OpenTelemetry로 퀵 스타트

프로세스

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 구성"을 참조하십시오.