OpenTelemetry Collector: OTLP HTTP 익스포터의 프록시 설정

OTLP HTTP 익스포터의 proxy_url 설정을 사용하고, 그 익스포터를 실제로 텔레메트리를 보내는 파이프라인에 연결하세요.

Collector는 애플리케이션에서 텔레메트리를 받은 뒤 구성된 백엔드로 별도의 아웃바운드 연결을 맺습니다. 프록시는 그 아웃바운드 HTTP 익스포터에 두세요:

exporters:
  otlp_http/proxied:
    endpoint: https://telemetry.example:4318
    proxy_url: http://proxy.example:8080

service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [otlp_http/proxied]

이 조각을 기존 구성에 병합하세요. otlp 리시버가 이미 정의되어 있다고 가정하며, 배포에 필요한 processors와 그 밖의 파이프라인 설정을 유지합니다. 익스포터를 정의하더라도 해당 파이프라인에서 참조하지 않으면 그 익스포터로 데이터가 전송되지 않습니다.

endpoint는 텔레메트리 백엔드의 기본 URL로 유지됩니다. OTLP HTTP 익스포터는 신호별 endpoint가 덮어쓰지 않는 한 /v1/traces 같은 신호 경로를 덧붙입니다. proxy_url은 중간자를 지정합니다. 민감하지 않고 공개되어 있으며 공개 프록시 경로를 허용하는 테스트 백엔드라면 HTTP 프록시 목록의 주소로 그 URL을 채울 수 있습니다. 백엔드의 실제 host와 port 접근을 확인하세요.

현재 upstream 문서는 이 컴포넌트를 otlp_http라 부르고 otlphttp는 더 이상 쓰이지 않는 별칭이라고 설명합니다. 구버전 배포판은 예전 컴포넌트 이름을 쓸 수 있으니, 익스포터 정의와 파이프라인 참조를 설치된 배포판에 맞춰 일관되게 유지하세요.

이것은 HTTP 클라이언트 구성입니다. OTLP gRPC 익스포터는 전송 방식이 다르고, 애플리케이션 자체의 프록시 환경이 Collector의 컨테이너나 서비스 프로세스로 자동 전달되지 않습니다. 마찬가지로 리시버 구성은 인바운드 트래픽에 대한 것이지 이 백엔드 연결에 대한 것이 아닙니다.

백엔드의 TLS 검증과 필요한 서비스 인증을 유지하세요. 프록시의 407과 백엔드의 거부는 서로 다른 계정과 단계를 가리킵니다.

관련 글