개요
Datadog은 관리형 플랫폼을 위한 전용 OTLP 수집 엔드포인트를 제공하므로 최소한의 구성으로 트레이스, 메트릭, 로그를 Datadog으로 직접 전송할 수 있습니다. 지원되는 각 플랫폼에는 고유한 OTLP 하위 도메인이 있습니다(예: cloudflare.integrations.otlp.datadoghq.com). 이러한 전용 엔드포인트를 통해 Datadog은 트래픽 소스를 식별하고 플랫폼별 처리 및 귀속을 적용할 수 있습니다. 일반 OTLP 엔드포인트는 호스트가 존재한다고 가정하므로 관리형 플랫폼 트래픽에 예상치 못한 동작을 유발할 수 있습니다.
Datadog Agent 또는 OpenTelemetry Collector를 설치할 수 없는 관리형 플랫폼에서 워크로드를 실행할 때 이 옵션을 사용하세요. 사용 중인 플랫폼이 아래 표에 없고 AWS, Azure 또는 GCP 서버리스 컴퓨팅에서 실행 중인 경우 Serverless를 참조하세요.
직접 OTLP 인테이크를 위한 호스트 이름 및 태깅에 대한 권장 사항은 호스트 이름 및 태깅을 참조하십시오.
각 엔드포인트는 다음 신호 경로를 지원합니다.
| 신호 | 경로 |
|---|
| 트레이스 | /v1/traces |
| 메트릭 | /v1/metrics |
| 로그 | /v1/logs |
신호별 구성(메트릭 변환, 로그 처리)에 대한 자세한 내용은 로그 및 메트릭 엔드포인트 페이지를 참조하세요.
구성
관리형 플랫폼 엔드포인트를 통해 Datadog으로 OTLP 데이터를 전송하려면 다음 환경 변수로 OpenTelemetry 익스포터를 구성하세요. {platform}을 지원되는 플랫폼 표에 있는 플랫폼의 하위 도메인으로 바꾸세요.
export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://{platform}.integrations.otlp."
export OTEL_EXPORTER_OTLP_HEADERS="dd-api-key=${DD_API_KEY}"
트레이스만 전송하려면:
export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://{platform}.integrations.otlp./v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY}"
관리형 플랫폼 엔드포인트는 dd-otlp-source 헤더를 사용하지 않습니다. 일반 OTLP 엔드포인트에서 마이그레이션하는 경우 구성에서 이 헤더를 제거하세요.
모든 엔드포인트는 https://{subdomain}.integrations.otlp/ 패턴을 따릅니다.
위에 나열되지 않은 관리형 플랫폼에서 OTLP 내보내기를 활성화하려면 고객 성공 관리자에게 문의하세요.
제한 사항
Collector나 Agent가 없으면 텔레메트리가 호스트 메타데이터로 보강되지 않습니다. 이 메타데이터에 의존하는 기능(예: Infrastructure Host List)은 사용할 수 없습니다. 영향을 받는 기능의 전체 목록은 OpenTelemetry 호환성 목록을 참조하세요.
제한된 정규화
Collector나 Agent가 자동으로 수행하는 일부 신호 처리는 직접 수집 시 수행되지 않습니다. 예를 들어, 누적 메트릭을 델타 메트릭으로 변환하려면 상태 저장 구성 요소가 필요합니다. 플랫폼이 누적 메트릭을 내보내는 경우, 델타 시간성을 내보내도록 SDK 또는 파이프라인을 구성하세요.
트레이스 메트릭
트레이스 메트릭은 관리형 플랫폼 엔드포인트에 대해 기본적으로 계산됩니다. 관리형 플랫폼은 내보내기 전에 트래픽을 샘플링할 수 있으며, 이는 트레이스 메트릭 정확도에 영향을 줄 수 있습니다.
샘플링
Collector에서 사용할 수 있는 샘플링 제어(테일 기반 샘플링, 확률적 샘플링)는 직접 수집 시 사용할 수 없습니다. 관리형 플랫폼은 내보내기 전에 자체 샘플링을 적용할 수 있습니다.
추가 자료
