OTLP Ingestion by the Datadog Agent

OTLP ingestion is off by default, and you can turn it on by updating your datadog.yaml file configuration or by setting environment variables. The following datadog.yaml configurations enable endpoints on the default ports.

For gRPC, default port 4317:

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

For HTTP, default port 4318:

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

Alternatively, configure the endpoints by providing the port through the environment variables:

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

These must be passed to both the core Agent and trace Agent processes. If running in a containerized environment, use 0.0.0.0 instead of localhost to ensure the server is available on non-local interfaces.

Configure either gRPC or HTTP for this feature. Here is an example application that shows configuration for both.

1. Follow the Datadog Docker Agent setup.

2. For the Datadog Agent container, set the following endpoint environment variables and expose the corresponding port:

   • For gPRC: Set DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT to 0.0.0.0:4317 and expose port 4317.
   • For HTTP: Set DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT to 0.0.0.0:4318 and expose port 4318.

1. Follow the Kubernetes Agent setup.

2. Configure the following environment variables in both the trace Agent container and the core Agent container:

   For gPRC:

   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. Map the container ports 4317 or 4318 to the host port for the core Agent container:

   For gPRC:

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

   For HTTP

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

1. Follow the Kubernetes Agent setup.

2. Enable the OTLP endpoints in the Agent by editing the datadog.otlp section of the values.yaml file:

   For gRPC:

   otlp:
    receiver:
      protocols:
        grpc:
          enabled: true
   

   For HTTP:

   otlp:
    receiver:
      protocols:
        http:
          enabled: true
   

This enables each protocol in the default port (4317 for OTLP/gRPC and 4318 for OTLP/HTTP).

1. Follow the Kubernetes Agent setup.

2. Enable the preferred protocol:

   For gRPC:

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

   For HTTP:

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

This enables each protocol in the default port (4317 for OTLP/gRPC and 4318 for OTLP/HTTP).

1. For the application container, set OTEL_EXPORTER_OTLP_ENDPOINT environment variable to point to the Datadog Agent container. For example:

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

2. Both containers must be defined in the same bridge network, which is handled automatically if you use Docker Compose. Otherwise, follow the Docker example in Tracing Docker Applications to set up a bridge network with the correct ports.

1. In the application deployment file, configure the endpoint that the OpenTelemetry client sends traces to with the OTEL_EXPORTER_OTLP_ENDPOINT environment variable:

   For gPRC:

   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
   

   For 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