L’ingestion OTLP est désactivée par défaut, et vous pouvez l’activer en mettant à jour votre datadog.yaml fichier de configuration ou en définissant des variables d’environnement. Les configurations suivantes datadog.yaml activent les points de terminaison sur les ports par défaut. Lorsqu’elle est activée, l’ingestion des métriques et des traces est activée par défaut. L’ingestion des journaux est désactivée par défaut pour éviter des frais imprévus liés aux journaux.

Pour gRPC, port par défaut 4317 :

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

Pour HTTP, port par défaut 4318 :

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

Alternativement, configurez les points de terminaison en fournissant le port via les variables d’environnement :

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

Ceux-ci doivent être transmis à la fois aux processus de l’Agent principal et de l’Agent de traces. Si vous exécutez dans un environnement conteneurisé, utilisez 0.0.0.0 au lieu de localhost pour garantir que le serveur est disponible sur des interfaces non locales.

Configurez soit gRPC soit HTTP pour cette fonctionnalité. Voici une application exemple qui montre la configuration pour les deux.

1. Suivez la configuration de l’Agent Docker Datadog.

2. Pour le conteneur de l’Agent Datadog, définissez les variables d’environnement de point de terminaison suivantes et exposez le port correspondant :

   • Pour gRPC : Définissez DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT sur 0.0.0.0:4317 et exposez le port 4317.
   • Pour HTTP : Définissez DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT sur 0.0.0.0:4318 et exposez le port 4318.

1. Suivez le guide d’installation de l’Agent Kubernetes pour l’installation de base.

2. Activez le protocole préféré gRPC ou HTTP dans le manifeste de votre Operator datadog-agent.yaml :

   Pour 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

Cela active chaque protocole sur le port par défaut (4317 pour OTLP/gRPC et 4318 pour OTLP/HTTP). Les métriques et les traces sont activées par défaut.

1. Suivez le guide d’installation de l’Agent Kubernetes pour l’installation de base.

2. Activez le protocole préféré gRPC ou HTTP dans le fichier datadog-values.yaml de votre Helm :

   Pour 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

Cela active chaque protocole sur le port par défaut (4317 pour OTLP/gRPC et 4318 pour OTLP/HTTP). Les métriques et les traces sont activées par défaut.

1. Suivez le guide d’installation manuelle de Kubernetes pour l’installation de base.

2. Configurez les variables d’environnement suivantes dans le conteneur trace-agent et le conteneur principal agent :

   Pour 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. Mappez les ports du conteneur 4317 ou 4318 au port de l’hôte pour le conteneur principal agent :

   Pour gRPC :

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

   For HTTP

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

Pour des instructions détaillées sur l’utilisation d’OpenTelemetry avec AWS Lambda et Datadog, y compris :

• Instrumenter vos fonctions Lambda avec OpenTelemetry
• Utiliser le support de l’API OpenTelemetry dans les SDK Datadog
• Envoyer des traces OpenTelemetry à l’extension Lambda de Datadog

Consultez la documentation Serverless pour AWS Lambda et OpenTelemetry.

1. Activez la collecte des journaux en suivant Host Agent Log collection setup :

   logs_enabled: true
   

2. Définir otlp_config.logs.enabled sur vrai :

   otlp_config:
     logs:
       enabled: true
   

Définissez les variables d’environnement suivantes dans le conteneur de l’agent Datadog :

• DD_LOGS_ENABLED=true
• DD_OTLP_CONFIG_LOGS_ENABLED=true

Dans votre fichier 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

Dans votre fichier 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

Définissez les variables d’environnement suivantes dans le conteneur de l’agent principal :

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

Pour plus d’informations, consultez la collecte des journaux avec votre DaemonSet.

Définissez la variable d’environnement OTEL_EXPORTER_OTLP_ENDPOINT dans l’environnement de votre application :

Pour gRPC :

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

Pour HTTP :

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

1. Pour le conteneur d’application, définissez la variable d’environnement OTEL_EXPORTER_OTLP_ENDPOINT pour pointer vers le conteneur de l’Agent Datadog. Exemple :

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

2. Les deux conteneurs doivent être définis dans le même réseau de pont, ce qui est géré automatiquement si vous utilisez Docker Compose. Sinon, suivez l’exemple Docker dans Tracing Docker Applications pour configurer un réseau de pont avec les ports corrects.

Dans le fichier de déploiement de l’application, configurez le point de terminaison auquel le client OpenTelemetry envoie les traces avec la variable d’environnement OTEL_EXPORTER_OTLP_ENDPOINT.

Pour 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

Pour 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

Remarque : Pour enrichir les balises de conteneur pour des métriques personnalisées, définissez les attributs de ressource appropriés dans le code de l’application où vos métriques OTLP sont générées. Par exemple, définissez l’attribut de ressource container.id sur l’UID du pod.