OTLP 수집은 기본적으로 꺼져 있으며, datadog.yaml 파일 구성을 업데이트하거나 환경 변수를 구성하여 활성화할 수 있습니다. 다음 datadog.yaml 구성은 기본 포트에서 엔드포인트를 활성화합니다. 활성화되면, 메트릭 및 트레이스 수집은 기본적으로 켜져 있습니다. 로그 수집은 예기치 않은 로그 과금을 방지하기 위해 기본적으로 비활성화되어 있습니다.

gRPC의 경우, 기본 포트 4317:

otlp_config:
  receiver:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
  logs:
    enabled: false

HTTP의 경우, 기본 포트 4318:

otlp_config:
  receiver:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
  logs:
    enabled: false

또는 환경 변수를 통해 포트를 제공하여 엔드포인트를 구성할 수 있습니다.

• gRPC의 경우(localhost:4317): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT
• HTTP의 경우(localhost:4318): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT

이 설정은 코어 Agent와 트레이스 Agent 프로세스 모두에 전달해야 합니다. 컨테이너화된 환경에서 실행 중인 경우, 서버가 로컬 인터페이스 외부에서도 접근 가능하도록 localhost 대신 0.0.0.0을 사용하세요.

이 기능에 대해 gRPC와 HTTP 중 하나를 선택하여 구성할 수 있습니다. 여기 두 가지에 대한 구성을 보여주는 예제 애플리케이션이 있습니다.

1. Datadog Docker Agent 설정을 따릅니다.

2. Datadog Agent 컨테이너의 경우, 다음 엔드포인트 환경 변수를 설정하고 해당 포트를 노출합니다.

   • gRPC의 경우: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT를 0.0.0.0:4317로 설정하고 포트 4317을 노출합니다.
   • HTTP의 경우: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT을 0.0.0.0:4318로 설정하고 포트 4318을 노출합니다.

1. Kubernetes Agent 설정을 따라 기본 설치를 진행합니다.

2. Operator의 datadog-agent.yaml 매니페스트에서 원하는 프로토콜(gRPC 또는 HTTP)을 활성화합니다.

   gRPC의 경우:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     # (...)
     features:
       otlp:
         receiver:
           protocols:
             grpc:
               enabled: true
   

   For HTTP:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     # (...)
     features:
       otlp:
         receiver:
           protocols:
             http:
               enabled: true
   

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

이렇게 하면 기본 포트(OTLP/gRPC: 4317, OTLP/HTTP: 4318)에서 각 프로토콜이 활성화됩니다. 메트릭 및 트레이스는 기본적으로 활성화되어 있습니다.

1. Kubernetes Agent 설정을 따라 기본 설치를 진행합니다.

2. Helm의 datadog-values.yaml 파일에서 원하는 프로토콜(gRPC 또는 HTTP)을 활성화합니다.

   gRPC의 경우:

   datadog:
     # (...)
     otlp:
       receiver:
         protocols:
           grpc:
             enabled: true
   

   For HTTP:

   datadog:
     # (...)
     otlp:
       receiver:
         protocols:
           http:
             enabled: true
   

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

이렇게 하면 기본 포트(OTLP/gRPC: 4317, OTLP/HTTP: 4318)에서 각 프로토콜이 활성화됩니다. 메트릭 및 트레이스는 기본적으로 활성화되어 있습니다.

1. 수동 Kubernetes 설치 가이드를 따라 기본 설치를 진행합니다..

2. 다음 환경 변수를 trace-agent 컨테이너와 핵심 agent 컨테이너 모두에 구성합니다.

   gRPC의 경우:

   name: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT # enables gRPC receiver on port 4317
   value: "0.0.0.0:4317"
   

   For HTTP:

   name: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT # enables HTTP receiver on port 4318
   value: "0.0.0.0:4318"
   

3. 컨테이너 포트 4317 또는 4318을 핵심 agent 컨테이너의 호스트 포트에 매핑합니다.

   gRPC의 경우:

   ports:
     - containerPort: 4317
       hostPort: 4317
       name: traceportgrpc
       protocol: TCP
   

   For HTTP

   ports:
     - containerPort: 4318
       hostPort: 4318
       name: traceporthttp
       protocol: TCP
   

AWS Lambda 및 Datadog에서 OpenTelemetry를 사용하는 방법에 대한 자세한 지침은 다음과 같습니다.

• OpenTelemetry로 Lambda 함수를 계측하기
• Datadog SDK 내에서 OpenTelemetry API 지원 사용하기
• OpenTelemetry 트레이스를 Datadog Lambda Extension으로 보내기

Serverless 설명서에서 AWS Lambda 및 OpenTelemetry를 참조하세요.

1. Host Agent 로그 수집 설정을 따라 로그 수집을 활성화합니다.

   logs_enabled: true
   

2. otlp_config.logs.enabled를 true로 설정합니다.

   otlp_config:
     logs:
       enabled: true
   

Datadog Agent 컨테이너에서 다음 환경 변수를 설정합니다.

• DD_LOGS_ENABLED=true
• DD_OTLP_CONFIG_LOGS_ENABLED=true

datadog-agent.yaml 파일

spec:
  # (...)
  features:
    otlp:
      #(... enable gRPC or HTTP ingestion...)
    logCollection:
      enabled: true
  override:
    nodeAgent:
      containers:
        agent:
          env:
            - name: DD_OTLP_CONFIG_LOGS_ENABLED
              value: "true"

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

datadog-values.yaml 파일:

datadog:
  # (...)
  otlp:
    #(... enable gRPC or HTTP ingestion...)
    logs:
      enabled: true
  logs:
    enabled: true

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

핵심 Agent 컨테이너에서 다음 환경 변수를 설정합니다.

- name: DD_LOGS_ENABLED
  value: "true"
- name: DD_OTLP_CONFIG_LOGS_ENABLED
  value: "true"

자세한 내용은 DaemonSet을 통한 로그 수집을 참조하세요.

애플리케이션의 환경에서 OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 설정합니다.

gRPC의 경우:

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317"

HTTP의 경우:

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

1. 애플리케이션 컨테이너의 경우, OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 Datadog Agent 컨테이너를 가리키도록 설정합니다. 예를 들면 다음과 같습니다.

   OTEL_EXPORTER_OTLP_ENDPOINT=http://<datadog-agent>:4318
   

2. 두 컨테이너는 동일한 브리지 네트워크에 정의되어야 하며, Docker Compose를 사용하면 자동으로 처리됩니다. 그렇지 않으면 Docker 애플리케이션 추적의 Docker 예제를 따라 올바른 포트로 브리지 네트워크를 설정합니다.

애플리케이션 배포 파일에서 OpenTelemetry 클라이언트가 트레이스를 전송할 엔드포인트를 OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 사용하여 구성합니다.

gRPC의 경우:

env:
 - name: HOST_IP
   valueFrom:
     fieldRef:
       fieldPath: status.hostIP
 - name: OTEL_EXPORTER_OTLP_ENDPOINT
   value: "http://$(HOST_IP):4317" # sends to gRPC receiver on port 4317

HTTP의 경우:

env:
 - name: HOST_IP
   valueFrom:
     fieldRef:
       fieldPath: status.hostIP
 - name: OTEL_EXPORTER_OTLP_ENDPOINT
   value: "http://$(HOST_IP):4318" # sends to HTTP receiver on port 4318

참고: 사용자 지정 메트릭에 대한 컨테이너 태그를 강화하려면 OTLP 메트릭이 생성되는 애플리케이션 코드에서 적절한 리소스 속성을 설정해야 합니다. 예를 들어, container.id 리소스 속성을 포드의 UID로 설정합니다.