4장. 수집기 구성

4.1.1. 배포 모드
링크 복사

OpenTelemetryCollector 사용자 정의 리소스를 사용하면 OpenTelemetry 수집기에 대해 다음 배포 모드 중 하나를 지정할 수 있습니다.

Deployment

기본값입니다.

StatefulSet

예를 들어 수집기의 File Storage Extension 또는 Tail Sampling Processor를 사용할 때 상태 저장 워크로드를 실행해야 하는 경우 StatefulSet 배포 모드를 사용합니다.

DaemonSet

예를 들어 수집기의 Filelog Receiver를 사용하여 컨테이너 로그를 읽는 등 모든 노드에서 Telemetry 데이터를 스크랩해야 하는 경우 DaemonSet 배포 모드를 사용합니다.

사이드카

컨테이너 내부의 로그 파일에 액세스해야 하는 경우 수집기를 사이드카로 삽입하고 수집기의 Filelog Receiver 및 emptyDir 과 같은 공유 볼륨을 사용합니다.

localhost 를 통해 Telemetry 데이터를 보내도록 애플리케이션을 구성해야 하는 경우 수집기를 사이드카로 삽입하고 암호화되고 인증된 연결을 통해 원격 분석 데이터를 외부 서비스로 전달하도록 수집기를 설정합니다. 수집기는 사이드카와 삽입될 때 애플리케이션과 동일한 Pod에서 실행됩니다.

참고

사이드카 배포 모드를 선택한 경우 OpenTelemetryCollector 사용자 정의 리소스 CR에서 spec.mode: sidecar 필드를 설정하는 것 외에도 sidecar.opentelemetry.io/inject 주석을 Pod 주석 또는 네임스페이스 주석으로 설정해야 합니다. Pod 및 네임 스페이스 모두에 이 주석을 설정하면 pod 주석이 false 또는 OpenTelemetryCollector CR 이름으로 설정된 경우 우선합니다.

pod 주석으로 sidecar.opentelemetry.io/inject 주석은 여러 값을 지원합니다.

apiVersion: v1
kind: Pod
metadata:
  ...
  annotations:
    sidecar.opentelemetry.io/inject: "<supported_value>" 
...

apiVersion: v1
kind: Pod
metadata:
  ...
  annotations:
    sidecar.opentelemetry.io/inject: "<supported_value>"

1

...

Copy to Clipboard

Toggle word wrap

1

지원되는 값:

false: 수집기를 삽입하지 않습니다. 주석이 없는 경우 이는 기본값입니다.
true: 동일한 네임스페이스에서 OpenTelemetryCollector CR의 구성으로 수집기를 삽입합니다.
<collector_name>: 동일한 네임스페이스에서 < collector_name > OpenTelemetryCollector CR의 구성으로 수집기를 삽입합니다.
<namespace>/<collector_name>: < namespace> 네임스페이스에서 < collector_name > OpenTelemetryCollector CR의 구성으로 수집기를 삽입합니다.

4.1.2. OpenTelemetry 수집기 구성 옵션
링크 복사

OpenTelemetry 수집기는 Telemetry 데이터에 액세스하는 5가지 유형의 구성 요소로 구성됩니다.

수신자
프로세서
내보내기
커넥터
확장

사용자 정의 리소스 YAML 파일에서 구성 요소의 여러 인스턴스를 정의할 수 있습니다. 구성하는 경우 YAML 파일의 spec.config.service 섹션에 정의된 파이프라인을 통해 이러한 구성 요소를 활성화해야 합니다. 필요한 구성 요소만 활성화하는 것이 좋습니다.

OpenTelemetry Collector 사용자 정의 리소스 파일의 예

apiVersion: opentelemetry.io/v1beta1
kind: OpenTelemetryCollector
metadata:
  name: cluster-collector
  namespace: tracing-system
spec:
  mode: deployment
  observability:
    metrics:
      enableMetrics: true
  config:
    receivers:
      otlp:
        protocols:
          grpc: {}
          http: {}
    processors: {}
    exporters:
      otlp:
        endpoint: otel-collector-headless.tracing-system.svc:4317
        tls:
          ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt"
      prometheus:
        endpoint: 0.0.0.0:8889
        resource_to_telemetry_conversion:
          enabled: true # by default resource attributes are dropped
    service: 
      pipelines:
        traces:
          receivers: [otlp]
          processors: []
          exporters: [otlp]
        metrics:
          receivers: [otlp]
          processors: []
          exporters: [prometheus]

apiVersion: opentelemetry.io/v1beta1
kind: OpenTelemetryCollector
metadata:
  name: cluster-collector
  namespace: tracing-system
spec:
  mode: deployment
  observability:
    metrics:
      enableMetrics: true
  config:
    receivers:
      otlp:
        protocols:
          grpc: {}
          http: {}
    processors: {}
    exporters:
      otlp:
        endpoint: otel-collector-headless.tracing-system.svc:4317
        tls:
          ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt"
      prometheus:
        endpoint: 0.0.0.0:8889
        resource_to_telemetry_conversion:
          enabled: true # by default resource attributes are dropped
    service:

1


      pipelines:
        traces:
          receivers: [otlp]
          processors: []
          exporters: [otlp]
        metrics:
          receivers: [otlp]
          processors: []
          exporters: [prometheus]

Copy to Clipboard

Toggle word wrap

1: 구성 요소가 구성되었지만 service 섹션에 정의되지 않은 경우 구성 요소가 활성화되지 않습니다.

Expand

표 4.1. Operator에서 OpenTelemetry Collector를 정의하는 데 사용하는 매개변수
매개변수	설명	값	기본
`receivers:` Copy to Clipboard Toggle word wrap	수신자는 데이터가 수집기로 들어오는 방법입니다. 기본적으로 수신자는 설정되어 있지 않습니다. 구성이 유효한 것으로 간주되려면 하나 이상의 사용 가능한 수신자가 있어야 합니다. 파이프라인에 추가되면 수신자가 활성화됩니다.	`otlp`,`jaeger`,`prometheus`,`zipkin`,`kafka`,`opencensus`	없음
`processors:` Copy to Clipboard Toggle word wrap	프로세서는 내보낸 데이터를 통해 실행됩니다. 기본적으로 프로세서는 사용할 수 없습니다.	`batch`,`memory_limiter`,`resourcedetection`,`attributes`,`span`,`k8sattributes`,`filter`,`routing`	없음
`exporters:` Copy to Clipboard Toggle word wrap	내보내기는 하나 이상의 백엔드 또는 대상에 데이터를 보냅니다. 기본적으로 내보내기는 구성되지 않습니다. 구성이 유효한 것으로 간주되려면 하나 이상의 활성화된 내보내기가 있어야 합니다. 파이프라인에 내보내기를 추가하여 사용할 수 있습니다. 내보내기는 기본 설정과 함께 사용할 수 있지만 대상 및 보안 설정을 지정하려면 많은 구성이 필요합니다.	`otlp`,`otlphttp`,`debug`,`prometheus`,`kafka`	없음
`connectors:` Copy to Clipboard Toggle word wrap	Connectors는 데이터를 end-of-pipeline 내보내기 도구로 사용하고 데이터를 초기-op-pipeline 수신자로 내보내 파이프라인 쌍을 결합합니다. 커넥터를 사용하여 소비된 데이터를 요약, 복제 또는 라우팅할 수 있습니다.	`spanmetrics`	없음
`extensions:` Copy to Clipboard Toggle word wrap	Telemetry 데이터를 처리하지 않는 작업의 선택적 구성 요소입니다.	`bearertokenauth`,`oauth2client`,`jaegerremotesampling`,`pprof`,`health_check`,`memory_ballast`,`zpages`	없음
`service: pipelines:` Copy to Clipboard Toggle word wrap	구성 요소는 `services.pipeline` 의 파이프라인에 추가하여 활성화됩니다.
`service: pipelines: traces: receivers:` Copy to Clipboard Toggle word wrap	`service.pipelines.traces` 에서 추적을 위해 수신자를 활성화합니다.		없음
`service: pipelines: traces: processors:` Copy to Clipboard Toggle word wrap	`service.pipelines.traces` 에서 추적을 위해 프로세서를 활성화합니다.		없음
`service: pipelines: traces: exporters:` Copy to Clipboard Toggle word wrap	`service.pipelines.traces` 에서 추적을 위해 내보내기를 활성화합니다.		없음
`service: pipelines: metrics: receivers:` Copy to Clipboard Toggle word wrap	`service.pipelines.metrics` 에 추가하여 메트릭의 수신자를 활성화합니다.		없음
`service: pipelines: metrics: processors:` Copy to Clipboard Toggle word wrap	`service.pipelines.metrics` 에 추가하여 metircs의 프로세서를 활성화합니다.		없음
`service: pipelines: metrics: exporters:` Copy to Clipboard Toggle word wrap	`service.pipelines.metrics` 에서 메트릭에 내보내기를 활성화합니다.		없음

4.1.3. 필요한 RBAC 리소스 자동 생성
링크 복사

일부 수집기 구성 요소에는 RBAC 리소스를 구성해야 합니다.

프로세스

OpenTelemetry Operator의 Red Hat 빌드가 자동으로 생성할 수 있도록 opentelemetry-operator-controller-manage 서비스 계정에 다음 권한을 추가합니다.

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: generate-processors-rbac
rules:
- apiGroups:
  - rbac.authorization.k8s.io
  resources:
  - clusterrolebindings
  - clusterroles
  verbs:
  - create
  - delete
  - get
  - list
  - patch
  - update
  - watch
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: generate-processors-rbac
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: generate-processors-rbac
subjects:
- kind: ServiceAccount
  name: opentelemetry-operator-controller-manager
  namespace: openshift-opentelemetry-operator

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: generate-processors-rbac
rules:
- apiGroups:
  - rbac.authorization.k8s.io
  resources:
  - clusterrolebindings
  - clusterroles
  verbs:
  - create
  - delete
  - get
  - list
  - patch
  - update
  - watch
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: generate-processors-rbac
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: generate-processors-rbac
subjects:
- kind: ServiceAccount
  name: opentelemetry-operator-controller-manager
  namespace: openshift-opentelemetry-operator

Copy to Clipboard

Toggle word wrap

4.1. 수집기 구성
링크 복사

4.1.1. 배포 모드
링크 복사

4.1.2. OpenTelemetry 수집기 구성 옵션
링크 복사

4.1.3. 필요한 RBAC 리소스 자동 생성
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4장. 수집기 구성

4.1. 수집기 구성링크 복사링크가 클립보드에 복사되었습니다!

4.1.1. 배포 모드링크 복사링크가 클립보드에 복사되었습니다!

4.1.2. OpenTelemetry 수집기 구성 옵션링크 복사링크가 클립보드에 복사되었습니다!

4.1.3. 필요한 RBAC 리소스 자동 생성링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4.1. 수집기 구성
링크 복사

4.1.1. 배포 모드
링크 복사

4.1.2. OpenTelemetry 수집기 구성 옵션
링크 복사

4.1.3. 필요한 RBAC 리소스 자동 생성
링크 복사