Kubernetes DaemonSet으로 DDOT Collector 설치

문서 > Datadog의 OpenTelemetry > Send OpenTelemetry Data to Datadog > Datadog OpenTelemetry Collector 배포판 > Install > Kubernetes DaemonSet으로 DDOT Collector 설치

개요

이 가이드는 Helm 또는 Datadog Operator를 사용하여 Kubernetes DaemonSet으로 Datadog Distribution of OpenTelemetry(DDOT) Collector를 배포하는 방법을 설명합니다.

추가 OpenTelemetry 구성 요소가 필요하신가요? 기본 패키지에 포함된 구성 요소 외에 추가 구성 요소가 필요한 경우 Datadog Agent 기능을 확장하기 위해 사용자 지정 OpenTelemetry 구성 요소 사용을 참조하세요. 기본적으로 포함되는 구성 요소 목록은 OpenTelemetry Collector 구성 요소를 참조하세요.

요구 사항

이 가이드를 완료하려면 다음이 필요합니다.

Datadog 계정:

Datadog 계정이 없는 경우 생성합니다.
Datadog API 키를 확인하거나 생성합니다.

소프트웨어: 다음을 시스템에 설치하고 구성합니다.

Kubernetes 클러스터(v1.29 이상)
Helm(v3 이상)
kubectl

네트워크: When using the Datadog SDK with OpenTelemetry API support, telemetry is routed to different components depending on the signal source. Ensure the following ports are accessible on your Datadog Agent or Collector:

Signal Source	Protocol	Port	Destination Component
OTel Metrics and Logs API	OTLP (gRPC/HTTP)	4317 / 4318	Datadog Agent OTLP Receiver or DDOT Collector
Datadog Tracing	Datadog trace intake	8126 (TCP)	Datadog Trace Agent
Runtime Metrics	DogStatsD	8125 (UDP)	DogStatsD Server

Datadog Agent와 OpenTelemetry Collector 설치

이 설치는 Datadog SDK + DDOT 및 OpenTelemetry SDK + DDOT 구성 모두에 필요합니다. Datadog SDK는 OpenTelemetry API를 구현하지만, OTLP 메트릭 및 로그를 처리하고 전달하기 위해서는 여전히 DDOT Collector가 필요합니다.

설치 방법 선택

다음 설치 방법 중 하나를 선택합니다.

Datadog Operator: Kubernetes 네이티브 방식으로 Datadog 설정을 자동으로 조정하고 유지 관리합니다. 사용자 지정 리소스 상태에 배포 상태, 상태 정보 및 오류를 보고하며, 상위 수준 구성 옵션을 통해 구성 오류의 위험을 줄입니다.
Helm 차트: Datadog Agent를 배포하는 간단한 방법입니다. 버전 관리, 롤백 및 템플릿 기능을 제공하므로 일관되고 더 쉽게 재현 가능한 배포가 가능합니다.

Datadog Operator 설치

Datadog Operator Helm 차트를 사용하여 클러스터에 Datadog Operator를 설치할 수 있습니다.

helm repo add datadog https://helm.datadoghq.com
helm repo update
helm install datadog-operator datadog/datadog-operator

Datadog Helm 저장소 추가

Datadog 저장소를 Helm 저장소 목록에 추가하려면 다음을 실행합니다.

helm repo add datadog https://helm.datadoghq.com
helm repo update

Datadog API 키 설정

Datadog API 키를 가져옵니다.
API 키를 Kubernetes 시크릿으로 저장합니다.
```
kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY>
```
<DD_API_KEY>를 실제 Datadog API 키로 교체합니다.

Datadog Agent 구성

Datadog Operator 배포 후 Kubernetes 클러스터에 Datadog Agent, Cluster Agent 및 Cluster Checks Runner(사용하는 경우)를 배포하는 DatadogAgent 리소스를 생성합니다. Datadog Agent는 DaemonSet으로 배포되며 클러스터의 각 노드에서 하나의 포드로 실행됩니다..

datadog-agent.yaml 파일을 사용하여 DatadogAgent 배포 구성을 지정합니다.

datadog-agent.yaml

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     global:
       clusterName: <CLUSTER_NAME>
       site: <DATADOG_SITE>
       credentials:
         apiSecret:
           secretName: datadog-secret
           keyName: api-key

<CLUSTER_NAME>을 클러스터 이름으로 바꿉니다.
<DATADOG_SITE>를 Datadog 사이트로 바꿉니다. 사이트는 현재 선택된 입니다(오른쪽에서 올바른 DATADOG SITE가 선택되어 있는지 확인).

OpenTelemetry Collector 활성화:

datadog-agent.yaml

  # Enable Features
  features:
    otelCollector:
      enabled: true

Datadog Operator는 기본적으로 OpenTelemetry Collector를 포트 4317(이름: otel-grpc) 및 4318(이름: otel-http)에 자동으로 바인딩합니다.

(선택 사항) 추가 Datadog 기능 활성화:

이 기능을 활성화하면 추가 비용이 발생할 수 있습니다. 진행하기 전에 가격 페이지를 검토하고 고객 성공 관리자와 상담하세요.

datadog-agent.yaml

  # Enable Features
  features:
  ...
    apm:
      enabled: true
    orchestratorExplorer:
      enabled: true
    processDiscovery:
      enabled: true
    liveProcessCollection:
      enabled: true
    usm:
      enabled: true
    clusterChecks:
      enabled: true

추가 Datadog 기능을 활성화할 때는 Datadog 환경 변수에 의존하지 말고 Datadog 또는 OpenTelemetry Collector 구성 파일을 사용하세요.

참고: Operator v1.22.0부터 DDOT 컨테이너는 ddot-collector 이미지를 사용하며 -full Agent 이미지는 사용하지 않습니다.

노드 Agent 이미지 태그를 재정의하는 경우 OTel 컨테이너가 스케줄링되도록 7.67.0 이상의 태그를 사용해야 합니다(ddot-collector 이미지는 7.67.0 이상에서만 지원됩니다).
이미지에는 ddot-collector``-full 변형이 없습니다. -full 이미지가 필요한 경우 spec.override.nodeAgent.image.name을 전체 Agent 이미지(예: registry.datadoghq.com/agent:7.72.1-full)로 설정하세요.

Datadog Agent 차트의 Helm Chart 파라미터를 지정하기 위해 YAML 파일을 사용합니다.

빈 datadog-values.yaml 파일 생성:

touch datadog-values.yaml

지정하지 않은 파라미터는 values.yaml의 기본값을 사용합니다.

Datadog API 키 시크릿 구성:

datadog-values.yaml

datadog:
  site: <DATADOG_SITE>
  apiKeyExistingSecret: datadog-secret

<DATADOG_SITE>를 Datadog 사이트로 설정합니다. 설정하지 않으면 기본값으로 US1 사이트(datadoghq.com)가 사용됩니다.

OpenTelemetry Collector 활성화 및 필수 포트 구성:

datadog-values.yaml

datadog:
  ...
  otelCollector:
    enabled: true
    ports:
      - containerPort: "4317" # default port for OpenTelemetry gRPC receiver.
        hostPort: "4317"
        name: otel-grpc
      - containerPort: "4318" # default port for OpenTelemetry HTTP receiver
        hostPort: "4318"
        name: otel-http

컨테이너 포트를 외부 네트워크에 노출하려면 hostPort을 설정합니다. 이를 통해 OTLP Exporter가 Datadog Agent가 배치된 노드의 IP 주소를 사용하도록 구성할 수 있습니다.

포트를 노출하고 싶지 않은 경우 Agent 서비스를 사용할 수도 있습니다.

이 경우 hostPort 항목을 datadog-values.yaml 파일에서 제거합니다.

애플리케이션 배포 파일(deployment.yaml)에서는 OTLP Exporter가 Agent 서비스를 사용하도록 구성합니다.

env:
  - name: OTEL_EXPORTER_OTLP_ENDPOINT
    value: 'http://<SERVICE_NAME>.<SERVICE_NAMESPACE>.svc.cluster.local'
  - name: OTEL_EXPORTER_OTLP_PROTOCOL
    value: 'grpc'

(선택 사항) 추가 Datadog 기능 활성화:

이 기능을 활성화하면 추가 비용이 발생할 수 있습니다. 진행하기 전에 가격 페이지를 검토하고 고객 성공 관리자와 상담하세요.

datadog-values.yaml

datadog:
  ...
  apm:
    portEnabled: true
    peer_service_aggregation: true
  orchestratorExplorer:
    enabled: true
  processAgent:
    enabled: true
    processCollection: true

추가 Datadog 기능을 활성화할 때는 Datadog 환경 변수에 의존하지 말고 Datadog 또는 OpenTelemetry Collector 구성 파일을 사용하세요.

(선택 사항) 포드 레이블을 수집하여 메트릭, 트레이스 및 로그에 연결되는 태그로 사용:

사용자 지정 메트릭은 과금에 영향을 줄 수 있습니다. 자세한 내용은 사용자 지정 메트릭 과금 페이지를 참조하세요.

datadog-values.yaml

datadog:
  ...
  podLabelsAsTags:
    app: kube_app
    release: helm_release

완성된 datadog-values.yaml 파일

완성된 datadog-values.yaml 파일은 다음과 유사해야 합니다.

datadog-values.yaml

datadog:
  site: datadoghq.com
  apiKeyExistingSecret: datadog-secret

  otelCollector:
    enabled: true
    ports:
      - containerPort: "4317"
        hostPort: "4317"
        name: otel-grpc
      - containerPort: "4318"
        hostPort: "4318"
        name: otel-http
  apm:
    portEnabled: true
    peer_service_aggregation: true
  orchestratorExplorer:
    enabled: true
  processAgent:
    enabled: true
    processCollection: true

  podLabelsAsTags:
    app: kube_app
    release: helm_release
   

OpenTelemetry Collector 구성

Datadog Operator는 시작점으로 사용할 수 있는 샘플 OpenTelemetry Collector 구성을 제공합니다. 이 구성을 수정해야 하는 경우 Datadog Operator는 사용자 지정 Collector 구성을 제공하는 두 가지 방법을 지원합니다.

인라인 구성: 사용자 지정 Collector 구성을 features.otelCollector.conf.configData 필드에 직접 추가합니다.
ConfigMap 기반 구성: Collector 구성을 ConfigMap에 저장한 후 features.otelCollector.conf.configMap 필드에서 참조합니다. 이 방식은 Collector 구성을 DatadogAgent 리소스와 분리하여 관리할 수 있게 해줍니다.

인라인 Collector 구성

아래 예제에서는 Collector 구성이 features.otelCollector.conf.configData 파라미터 아래에 직접 정의됩니다.

datadog-agent.yaml

  ...
  # Enable Features
  features:
    otelCollector:
      enabled: true
      ports:
        - containerPort: 4317
          hostPort: 4317
          name: otel-grpc
        - containerPort: 4318
          hostPort: 4318
          name: otel-http
      conf:
        configData: |-
          receivers:
            prometheus:
              config:
                scrape_configs:
                  - job_name: "otelcol"
                    scrape_interval: 10s
                    static_configs:
                      - targets:
                          - 0.0.0.0:8888
            otlp:
              protocols:
                grpc:
                  endpoint: 0.0.0.0:4317
                http:
                  endpoint: 0.0.0.0:4318
          exporters:
            debug:
              verbosity: detailed
            datadog:
              api:
                key: ${env:DD_API_KEY}
                site: ${env:DD_SITE}
              sending_queue:
                batch:
                  flush_timeout: 10s
          processors:
            infraattributes:
              cardinality: 2
          connectors:
            datadog/connector:
              traces:
          service:
            pipelines:
              traces:
                receivers: [otlp]
                processors: [infraattributes]
                exporters: [debug, datadog, datadog/connector]
              metrics:
                receivers: [otlp, datadog/connector, prometheus]
                processors: [infraattributes]
                exporters: [debug, datadog]
              logs:
                receivers: [otlp]
                processors: [infraattributes]
                exporters: [debug, datadog]

For the infraattributes processor to add Kubernetes tags, your telemetry must include the container.id resource attribute. This is often, but not always, added by OTel SDK auto-instrumentation.

If your tags are missing, see the troubleshooting guide for details on how to add this attribute.

이 DatadogAgent 리소스가 포함된 datadog-agent.yaml 파일을 적용하면 Operator가 Collector 구성을 Agent DaemonSet에 자동으로 마운트합니다.

인라인 Collector 구성이 포함된 완성된 datadog-agent.yaml

인라인 Collector 구성을 포함한 완성된 datadog-agent.yaml은 다음과 유사해야 합니다.

datadog-agent.yaml

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

  # Enable Features
  features:
    apm:
      enabled: true
    orchestratorExplorer:
      enabled: true
    processDiscovery:
      enabled: true
    liveProcessCollection:
      enabled: true
    usm:
      enabled: true
    clusterChecks:
      enabled: true
    otelCollector:
      enabled: true
      ports:
        - containerPort: 4317
          hostPort: 4317
          name: otel-grpc
        - containerPort: 4318
          hostPort: 4318
          name: otel-http
      conf:
        configData: |-
          receivers:
            prometheus:
              config:
                scrape_configs:
                  - job_name: "datadog-agent"
                    scrape_interval: 10s
                    static_configs:
                      - targets:
                          - 0.0.0.0:8888
            otlp:
              protocols:
                grpc:
                  endpoint: 0.0.0.0:4317
                http:
                  endpoint: 0.0.0.0:4318
          exporters:
            debug:
              verbosity: detailed
            datadog:
              api:
                key: ${env:DD_API_KEY}
                site: ${env:DD_SITE}
              sending_queue:
                batch:
                  flush_timeout: 10s
          processors:
            infraattributes:
              cardinality: 2
          connectors:
            datadog/connector:
              traces:
          service:
            pipelines:
              traces:
                receivers: [otlp]
                processors: [infraattributes]
                exporters: [debug, datadog, datadog/connector]
              metrics:
                receivers: [otlp, datadog/connector, prometheus]
                processors: [infraattributes]
                exporters: [debug, datadog]
              logs:
                receivers: [otlp]
                processors: [infraattributes]
                exporters: [debug, datadog]

ConfigMap 기반 Collector 구성

구성이 복잡하거나 자주 변경되는 경우에는 Collector 구성을 ConfigMap에 저장하면 버전 관리가 더 쉬워집니다.

Collector 구성이 포함된 ConfigMap 생성:

configmap.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: otel-agent-config-map
  namespace: system
data:
  # must be named otel-config.yaml
  otel-config.yaml: |-
    receivers:
      prometheus:
        config:
          scrape_configs:
            - job_name: "datadog-agent"
              scrape_interval: 10s
              static_configs:
                - targets:
                    - 0.0.0.0:8888
      otlp:
        protocols:
          grpc:
            endpoint: 0.0.0.0:4317
          http:
            endpoint: 0.0.0.0:4318
    exporters:
      debug:
        verbosity: detailed
      datadog:
        api:
          key: ${env:DD_API_KEY}
          site: ${env:DD_SITE}
        sending_queue:
          batch:
            flush_timeout: 10s
    processors:
      infraattributes:
        cardinality: 2
    connectors:
      datadog/connector:
        traces:
    service:
      pipelines:
        traces:
          receivers: [otlp]
          processors: [infraattributes]
          exporters: [debug, datadog, datadog/connector]
        metrics:
          receivers: [otlp, datadog/connector, prometheus]
          processors: [infraattributes]
          exporters: [debug, datadog]
        logs:
          receivers: [otlp]
          processors: [infraattributes]
          exporters: [debug, datadog]

ConfigMap 내 Collector 구성 필드 이름은 otel-config.yaml이어야 합니다.

features.otelCollector.conf.configMap 파라미터를 사용하여 DatadogAgent 리소스에서 해당 otel-agent-config-map ConfigMap을 참조합니다.

datadog-agent.yaml

  ...
  # Enable Features
  features:
    otelCollector:
      enabled: true
      ports:
        - containerPort: 4317
          hostPort: 4317
          name: otel-grpc
        - containerPort: 4318
          hostPort: 4318
          name: otel-http
      conf:
        configMap:
          name: otel-agent-config-map

Operator는 ConfigMap의 otel-config.yaml을 Agent의 OpenTelemetry Collector DaemonSet에 자동으로 마운트합니다.

ConfigMap에 정의된 Collector 구성이 포함된 완성된 datadog-agent.yaml

Collector 구성을 ConfigMap으로 정의한 완성된 datadog-agent.yaml은 다음과 유사해야 합니다.

datadog-agent.yaml

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

  # Enable Features
  features:
    apm:
      enabled: true
    orchestratorExplorer:
      enabled: true
    processDiscovery:
      enabled: true
    liveProcessCollection:
      enabled: true
    usm:
      enabled: true
    clusterChecks:
      enabled: true
    otelCollector:
      enabled: true
      ports:
        - containerPort: 4317
          hostPort: 4317
          name: otel-grpc
        - containerPort: 4318
          hostPort: 4318
          name: otel-http
      conf:
        configMap:
          name: otel-agent-config-map
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: otel-agent-config-map
  namespace: system
data:
  # must be named otel-config.yaml
  otel-config.yaml: |-
    receivers:
      prometheus:
        config:
          scrape_configs:
            - job_name: "datadog-agent"
              scrape_interval: 10s
              static_configs:
                - targets:
                    - 0.0.0.0:8888
      otlp:
        protocols:
          grpc:
            endpoint: 0.0.0.0:4317
          http:
            endpoint: 0.0.0.0:4318
    exporters:
      debug:
        verbosity: detailed
      datadog:
        api:
          key: ${env:DD_API_KEY}
          site: ${env:DD_SITE}
        sending_queue:
          batch:
            flush_timeout: 10s
    processors:
      infraattributes:
        cardinality: 2
    connectors:
      datadog/connector:
        traces:
    service:
      pipelines:
        traces:
          receivers: [otlp]
          processors: [infraattributes]
          exporters: [debug, datadog, datadog/connector]
        metrics:
          receivers: [otlp, datadog/connector, prometheus]
          processors: [infraattributes]
          exporters: [debug, datadog]
        logs:
          receivers: [otlp]
          processors: [infraattributes]
          exporters: [debug, datadog]

Datadog Helm 차트는 시작점으로 사용할 수 있는 샘플 OpenTelemetry Collector 구성을 제공합니다. 이 섹션에서는 미리 정의된 파이프라인과 포함된 OpenTelemetry 구성 요소를 설명합니다.

다음은 otel-config.yaml에 포함되는 전체 OpenTelemetry Collector 구성입니다.

otel-config.yaml

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: "otelcol"
          scrape_interval: 10s
          static_configs:
            - targets: ["0.0.0.0:8888"]
  otlp:
    protocols:
      grpc:
         endpoint: 0.0.0.0:4317
      http:
         endpoint: 0.0.0.0:4318
exporters:
  debug:
    verbosity: detailed
  datadog:
    api:
      key: ${env:DD_API_KEY}
      site: ${env:DD_SITE}
    sending_queue:
      batch:
        flush_timeout: 10s
processors:
  infraattributes:
    cardinality: 2
connectors:
  datadog/connector:
    traces:
service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [infraattributes]
      exporters: [datadog, datadog/connector]
    metrics:
      receivers: [otlp, datadog/connector, prometheus]
      processors: [infraattributes]
      exporters: [datadog]
    logs:
      receivers: [otlp]
      processors: [infraattributes]
      exporters: [datadog]

For the infraattributes processor to add Kubernetes tags, your telemetry must include the container.id resource attribute. This is often, but not always, added by OTel SDK auto-instrumentation.

If your tags are missing, see the troubleshooting guide for details on how to add this attribute.

주요 구성 요소

Datadog으로 텔레메트리 데이터를 전송하기 위해 다음 구성 요소가 정의되어 있습니다.

Datadog 커넥터

Datadog 커넥터는 Datadog APM 트레이스 메트릭을 계산합니다.

otel-config.yaml

connectors:
  datadog/connector:
    traces:

Datadog 익스포터

Datadog 익스포터는 트레이스, 메트릭 및 로그를 Datadog으로 내보냅니다.

otel-config.yaml

exporters:
  datadog:
    api:
      key: ${env:DD_API_KEY}
      site: ${env:DD_SITE}
    sending_queue:
      batch:
        flush_timeout: 10s

참고: key가 지정되지 않았거나 시크릿으로 설정된 경우 또는 site가 지정되지 않은 경우 시스템은 핵심 Agent 구성의 값을 사용합니다. 기본적으로 핵심 Agent는 사이트를 datadoghq.com(US1)으로 설정합니다.

Prometheus 수신기

Prometheus 수신기는 메트릭 파이프라인을 위해 OpenTelemetry Collector의 상태 메트릭을 수집합니다.

otel-config.yaml

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: "otelcol"
          scrape_interval: 10s
          static_configs:
            - targets: ["0.0.0.0:8888"]

자세한 내용은 Collector Health Metrics 설명서를 참조하세요.

OpenTelemetry Collector와 함께 Agent 배포

구성 파일을 사용하여 Datadog Agent를 배포합니다.

kubectl apply -f datadog-agent.yaml

이 작업은 DDOT OpenTelemetry Collector가 포함된 Datadog Agent를 DaemonSet으로 배포합니다. Collector는 Agent 배포 패턴에 따라 애플리케이션과 동일한 호스트에서 실행됩니다. Gateway 배포 패턴은 현재 Preview 상태입니다. 설치 방법은 DDOT Kubernetes Gateway 설치 가이드를 참조하세요.

Kubernetes 환경에서 OpenTelemetry Collector와 함께 Datadog Agent를 설치하거나 업그레이드하려면 다음 Helm 명령 중 하나를 사용합니다.

기본 OpenTelemetry Collector 구성 사용:

helm upgrade -i <RELEASE_NAME> datadog/datadog -f datadog-values.yaml

사용자 지정 OpenTelemetry Collector 구성 사용:

helm upgrade -i <RELEASE_NAME> datadog/datadog \
  -f datadog-values.yaml \
  --set-file datadog.otelCollector.config=otel-config.yaml

이 명령을 사용하면 자체 otel-config.yaml 파일을 지정할 수 있습니다.

<RELEASE_NAME>은 사용 중인 Helm 릴리스 이름으로 바꾸세요.

배포 과정에서 경고 메시지가 표시될 수 있습니다. 이러한 경고는 무시해도 됩니다.

이 Helm 차트는 OpenTelemetry Collector가 포함된 Datadog Agent를 DaemonSet으로 배포합니다. Collector는 Agent 배포 패턴에 따라 애플리케이션과 동일한 호스트에 배포됩니다. Gateway 배포 패턴은 현재 Preview 상태입니다. 설치 방법은 DDOT Kubernetes Gateway 설치 가이드를 참조하세요.

배포 다이어그램

Datadog으로 텔레메트리 전송

텔레메트리 데이터를 Datadog으로 전송하려면 다음 단계를 수행합니다.

애플리케이션 계측
애플리케이션 구성
관측성 데이터 상관관계 설정
애플리케이션 실행

애플리케이션 계측

OpenTelemetry API를 사용하여 애플리케이션을 계측합니다.

OpenTelemetry API로 계측된 예제 애플리케이션

예제로는 이미 계측이 완료된 Calendar 샘플 애플리케이션을 사용할 수 있습니다. 다음 코드는 OpenTelemetry 주석 및 API를 사용하여 CalendarService.getDate() 메서드를 계측합니다.

CalendarService.java

@WithSpan(kind = SpanKind.CLIENT)
public String getDate() {
    Span span = Span.current();
    span.setAttribute("peer.service", "random-date-service");
    ...
}

애플리케이션 구성

애플리케이션 컨테이너는 동일한 호스트에서 실행 중인 DDOT Collector로 데이터를 전송해야 합니다. Collector는 DaemonSet으로 실행되므로 OTLP 엔드포인트로 로컬 호스트를 지정해야 합니다.

OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수가 아직 설정되어 있지 않은 경우 애플리케이션의 Deployment 매니페스트 파일에 추가합니다.

deployment.yaml

env:
  ...
  - name: HOST_IP
    valueFrom:
     fieldRef:
        fieldPath: status.hostIP
  - name: OTLP_GRPC_PORT
    value: "4317"
  - name: OTEL_EXPORTER_OTLP_ENDPOINT
    value: 'http://$(HOST_IP):$(OTLP_GRPC_PORT)'
  - name: OTEL_EXPORTER_OTLP_PROTOCOL
    value: 'grpc'
   

관측성 데이터 상관관계 설정

unified service tagging은 Datadog에서 메트릭, 트레이스 및 로그를 일관된 태그로 연결하여 서로 간에 쉽게 탐색할 수 있도록 해줍니다.

컨테이너화된 환경에서는 OpenTelemetry Resource Attributes 환경 변수를 사용하여 env, service, version을 설정합니다. DDOT Collector는 이러한 태깅 구성을 감지하고 컨테이너에서 수집한 데이터에 자동으로 적용합니다.

애플리케이션의 Deployment 매니페스트에 다음 환경 변수를 추가합니다.

deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: <SERVICE>
spec:
  template:
    spec:
      containers:
      - name: <SERVICE>
        env:
          - name: OTEL_SERVICE_NAME
            value: "<SERVICE>"
          - name: OTEL_RESOURCE_ATTRIBUTES
            value: "service.version=<VERSION>,deployment.environment.name=<ENV>"