3.2. CLI를 사용하여 OpenTelemetry Red Hat 빌드 설치

프로세스

1. OpenTelemetry Operator의 Red Hat 빌드를 설치합니다.

   1. 다음 명령을 실행하여 Red Hat build of OpenTelemetry Operator 프로젝트를 생성합니다.

      $ oc apply -f - << EOF
      apiVersion: project.openshift.io/v1
      kind: Project
      metadata:
        labels:
          kubernetes.io/metadata.name: openshift-opentelemetry-operator
          openshift.io/cluster-monitoring: "true"
        name: openshift-opentelemetry-operator
      EOF

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 Operator group을 생성합니다.

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-opentelemetry-operator
        namespace: openshift-opentelemetry-operator
      spec:
        upgradeStrategy: Default
      EOF

      Copy to Clipboard Toggle word wrap

   3. 다음 명령을 실행하여 서브스크립션을 생성합니다.

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: opentelemetry-product
        namespace: openshift-opentelemetry-operator
      spec:
        channel: stable
        installPlanApproval: Automatic
        name: opentelemetry-product
        source: redhat-operators
        sourceNamespace: openshift-marketplace
      EOF

      Copy to Clipboard Toggle word wrap

   4. 다음 명령을 실행하여 Operator 상태를 확인합니다.

      $ oc get csv -n openshift-opentelemetry-operator

      Copy to Clipboard Toggle word wrap

2. 후속 단계에서 생성할 OpenTelemetry 수집기 인스턴스에 대해 선택한 허용된 프로젝트를 생성합니다.

   • 메타데이터 없이 허용된 프로젝트를 생성하려면 다음 명령을 실행합니다.

     $ oc new-project <permitted_project_of_opentelemetry_collector_instance> 

     1

     Copy to Clipboard Toggle word wrap

     1

     openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

   • 메타데이터를 사용하여 허용된 프로젝트를 생성하려면 다음 명령을 실행합니다.

     $ oc apply -f - << EOF
     apiVersion: project.openshift.io/v1
     kind: Project
     metadata:
       name: <permitted_project_of_opentelemetry_collector_instance> 

     1

     
     EOF

     Copy to Clipboard Toggle word wrap

     1

     openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

3. 사용자가 생성한 프로젝트에서 OpenTelemetry 수집기 인스턴스를 생성합니다.

   참고

   동일한 클러스터의 별도의 프로젝트에서 여러 OpenTelemetry 수집기 인스턴스를 생성할 수 있습니다.

   1. OpenTelemetryCollector 사용자 정의 리소스(CR)를 사용자 지정합니다.

      OpenTelemetryCollector CR의 예

      apiVersion: opentelemetry.io/v1beta1
      kind: OpenTelemetryCollector
      metadata:
        name: otel
        namespace: <permitted_project_of_opentelemetry_collector_instance> 

      1

      
      spec:
        mode: <deployment_mode> 

      2

      
        config:
          receivers: 

      3

      
            otlp:
              protocols:
                grpc:
                http:
            jaeger:
              protocols:
                grpc: {}
                thrift_binary: {}
                thrift_compact: {}
                thrift_http: {}
            zipkin: {}
          processors: 

      4

      
            batch: {}
            memory_limiter:
              check_interval: 1s
              limit_percentage: 50
              spike_limit_percentage: 30
          exporters: 

      5

      
            debug: {}
          service:
            pipelines:
              traces:
                receivers: [otlp,jaeger,zipkin]
                processors: [memory_limiter,batch]
                exporters: [debug]

      Copy to Clipboard Toggle word wrap

      1

      OpenTelemetryCollector 배포를 위해 선택한 프로젝트입니다. openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

      2

      지원되는 다음 값이 있는 배포 모드: 기본 배포,daemonset,statefulset 또는 사이드카. 자세한 내용은 배포 모드를 참조하십시오.

      3

      자세한 내용은 수신자를 참조하십시오.

      4

      자세한 내용은 프로세서를 참조하십시오.

      5

      자세한 내용은 내보내기를 참조하십시오.

   2. 다음 명령을 실행하여 사용자 지정된 CR을 적용합니다.

      $ oc apply -f - << EOF
      <OpenTelemetryCollector_custom_resource>
      EOF

      Copy to Clipboard Toggle word wrap

검증

1. 다음 명령을 실행하여 OpenTelemetry 수집기 Pod의 status.phase 이 Running 이고 conditions가 type: Ready 인지 확인합니다.

   $ oc get pod -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name> -o yaml

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 OpenTelemetry 수집기 서비스를 가져옵니다.

   $ oc get service -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name>

   Copy to Clipboard Toggle word wrap