La ingesta OTLP está desactivada por defecto, y puedes activarla actualizando la configuración de tu archivo datadog.yaml o estableciendo las variables de entorno. Las siguientes configuraciones de datadog.yaml habilitan endpoints en los puertos por defecto.

Para gRPC, puerto por defecto 4317:

otlp_config:
  receiver:
    protocols:
      grpc:
        endpoint: localhost:4317

Para HTTP, puerto por defecto 4318:

otlp_config:
  receiver:
    protocols:
      http:
        endpoint: localhost:4318

Alternativamente, configura los endpoints proporcionando el puerto a través de las variables de entorno:

• Para gRPC (localhost:4317): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT
• Para HTTP (localhost:4318): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT

Estos deben pasarse tanto a los procesos centrales del Agent como los del Trace Agent. Si se ejecuta en un entorno contenedorizado, utiliza 0.0.0.0 en lugar de localhost para garantizar que el servidor esté disponible en interfaces no locales.

Configura ya sea gRPC o HTTP para esta función. Aquí hay una aplicación de ejemplo que muestra la configuración para ambos.

La ingesta OTLP de logs en el Datadog Agent está desactivada por defecto para que no se produzca un uso inesperado de logs que pueda afectar tu facturación. Para habilitar la ingesta OTLP de logs:

1. Habilita explícitamente la recopilación de logs en su conjunto siguiendo la configuración de la recopilación de logs del Host Agent:

   logs_enabled: true
   

2. Establece otlp_config.logs.enabled en true:

   otlp_config:
     logs:
       enabled: true
   

1. Sigue la configuración del Datadog Docker Agent.

2. Para el contenedor del Datadog Agent, establece las siguientes variables de entorno de endpoint y expone el puerto correspondiente:

   • Para gRPC: establece DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT en 0.0.0.0:4317 y expone el puerto 4317.
   • Para HTTP: establece DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT en 0.0.0.0:4318 y expone el puerto 4318.

3. Si deseas habilitar la ingesta OTLP de logs, configura las siguientes variables de entorno de endpoint en el contenedor del Datadog Agent:

   • Establece DD_LOGS_ENABLED en true.
   • Establece DD_OTLP_CONFIG_LOGS_ENABLED en true.

1. Sigue la [configuración de Kubernetes Agent1.

2. Configura las siguientes variables de entorno tanto en el contenedor del Trace Agent como en el contenedor principal del Agent:

   Para gRPC:

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

   Para HTTP:

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

3. Asigna los puertos de contenedor 4317 o 4318 al puerto host para el contenedor principal del Agent:

   Para gRPC:

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

   Para HTTP

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

4. Si deseas habilitar la ingesta OTLP de logs, configura las siguientes variables de entorno de endpoint en el contenedor principal del Agent:

   Habilita la recopilación de logs con tu DaemonSet:

   name: DD_LOGS_ENABLED
   value: "true"
   

   Y activa la ingesta OTLP de logs:

   name: DD_OTLP_CONFIG_LOGS_ENABLED
   value: "true"
   

1. Sigue la [configuración de Kubernetes Agent1.

2. Habilita los endpoints OTLP en el Agent editando la sección datadog.otlp del archivo values.yaml:

   Para gRPC:

   otlp:
    receiver:
      protocols:
        grpc:
          enabled: true
   

   Para HTTP:

   otlp:
    receiver:
      protocols:
        http:
          enabled: true
   

Esto habilita cada protocolo en el puerto por defecto (4317 para OTLP/gRPC y 4318 para OTLP/HTTP).

1. Sigue la [configuración de Kubernetes Agent1.

2. Activa el protocolo preferido:

   Para gRPC:

   --set "datadog.otlp.receiver.protocols.grpc.enabled=true"
   

   Para HTTP:

   --set "datadog.otlp.receiver.protocols.http.enabled=true"
   

Esto habilita cada protocolo en el puerto por defecto (4317 para OTLP/gRPC y 4318 para OTLP/HTTP).

1. Para el contenedor de la aplicación, configura la variable de entorno OTEL_EXPORTER_OTLP_ENDPOINT para que apunte al contenedor del Datadog Agent. Por ejemplo:

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

2. Ambos contenedores deben estar definidos en el mismo puente red, que se gestiona automáticamente si utilizas Docker Compose. De lo contrario, sigue el ejemplo de Docker en Rastreo de aplicaciones Docker para configurar un puente red con los puertos correctos.

En el archivo de despliegue de la aplicación, configura el endpoint al que el cliente de OpenTelemetry envía trazas con la variable de entorno OTEL_EXPORTER_OTLP_ENDPOINT.

Para 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

Para 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

Nota: Para mejorar las etiquetas (tags) de contenedor para métricas personalizadas, establece los atributos de recurso apropiados en el código de la aplicación donde se generan tus métricas OTLP. Por ejemplo, establece el atributo de recurso container.id en el UID del pod.