DDOT Datadog est la distribution du Collector OpenTelemetry que Datadog embarque dans son Agent. Pour une équipe SRE qui exploite déjà l’Agent, la question est simple : faut-il garder un Collector amont séparé, ou laisser l’Agent porter aussi les pipelines OpenTelemetry ? Cet article décrit ce que DDOT contient, comment l’installer sur Kubernetes et sur Linux, et ce qu’il change pour l’exploitation, d’après la documentation Datadog consultée le 30 octobre 2026.
Périmètre : ce texte concerne Datadog, pas Dynatrace. Il sert de point de comparaison honnête pour qui choisit comment acheminer ses signaux OpenTelemetry. Pour le contexte plus large, voir le comparatif Dynatrace et Datadog.
DDOT Datadog : ce que c’est
Selon la documentation Datadog, le DDOT Collector (Datadog Distribution of OpenTelemetry) est une solution open source qui « combine la flexibilité d’OpenTelemetry avec les capacités d’observabilité de Datadog ». Il est intégré à l’Agent Datadog et regroupe trois choses : des composants OpenTelemetry sélectionnés, la collecte et le traitement propres à l’Agent, et quelques composants Datadog sur mesure.
Ce n’est donc pas le Collector « contrib » complet. La documentation liste un ensemble précis de composants :
- Receivers :
otlpreceiver,prometheusreceiver,filelogreceiver,hostmetricsreceiver,kubeletstatsreceiver,jaegerreceiver,zipkinreceiver, entre autres ; - Processors :
batchprocessor,memorylimiterprocessor,k8sattributesprocessor,resourcedetectionprocessor,transformprocessor,tailsamplingprocessor,probabilisticsamplerprocessor, etc. ; - Exporters :
datadogexporter,otlpexporter,otlphttpexporter,loadbalancingexporter,debugexporter; - Connectors :
datadogconnector,routingconnector,spanmetricsconnector; - Composants Datadog : un Infrastructure Attribute Processor, un Converter et une extension DD Flare.
Si un composant manque, la documentation renvoie vers un guide « Use Custom OpenTelemetry Components ». Le fichier de référence est le manifeste du dépôt DataDog/datadog-agent (comp/otelcol/collector-contrib/impl/manifest.yaml). Vérifiez-le avant de migrer une configuration existante : c’est la première cause de blocage.
Prérequis et versions à connaître
La page d’installation Kubernetes indique ces prérequis :
- un cluster Kubernetes en version 1.29 ou plus récente ;
- Helm 3 ou plus, et
kubectl; - un compte et une clé d’API Datadog ;
- un tag d’image de l’Agent 7.67.0 ou plus pour l’image
ddot-collector; - avec le Datadog Operator, la version 1.22.0 ou plus : le conteneur DDOT utilise alors l’image
ddot-collectorau lieu de l’image-full.
Les ports à rendre joignables sont 4317 et 4318 (OTLP gRPC et HTTP), 8126 en TCP (intake de traces Datadog) et 8125 en UDP (DogStatsD). Sur le plan de la maturité, la page principale ne déclare pas de statut global (GA ou preview). Elle signale seulement que la configuration à distance (Remote Configuration) du DDOT Collector est en Preview, et la page de migration indique que le déploiement en Gateway est en Preview. Le DaemonSet y est présenté comme le mode pris en charge. EKS Fargate n’est pas pris en charge.
Je n’ai pas pu confirmer un numéro de version minimal unique de l’Agent pour DDOT : la page principale ne le donne pas. Un éventuel seuil « 7.65 » n’est donc pas vérifié ; retenez les seuils cités ci-dessus (7.67.0, 7.78).
Installer le DDOT Collector sur Kubernetes avec Helm
Étape 1 : ajoutez le dépôt et créez le secret de la clé d’API.
helm repo add datadog https://helm.datadoghq.com
helm repo update
kubectl create secret generic datadog-secret \
--from-literal api-key=<DD_API_KEY>
Étape 2 : activez le Collector dans le fichier de valeurs. La clé utile est datadog.otelCollector.enabled. Les ports hostPort exposent OTLP sur le nœud.

Étape 3 : déployez avec la configuration par défaut du Collector.
helm upgrade -i <RELEASE_NAME> datadog/datadog -f datadog-values.yaml
Pour une configuration de pipeline personnalisée, ajoutez --set-file datadog.otelCollector.config=otel-config.yaml. Avec le Datadog Operator, l’équivalent est features.otelCollector.enabled: true dans la ressource DatadogAgent (datadoghq.com/v2alpha1) ; l’Operator lie alors le Collector aux ports 4317 et 4318 par défaut.
La configuration par défaut décrite par la documentation comprend un receiver otlp pour tous les signaux, un receiver prometheus, les processors infraattributes et cumulativetodelta, et l’exporter datadog. L’exporter lit ${env:DD_API_KEY} et ${env:DD_SITE}. Pour que infraattributes ajoute les tags Kubernetes, la télémétrie doit porter l’attribut de ressource container.id.
Installer DDOT sur Linux
La documentation couvre aussi les hôtes Linux (bare-metal et machines virtuelles). Sur un nouvel hôte, le script d’installation de l’Agent accepte la variable DD_OTELCOLLECTOR_ENABLED=true. Sur un hôte où l’Agent est déjà présent en version 7.78 ou plus, la commande sudo datadog-agent otel install ajoute le Collector.

Le fichier /etc/datadog-agent/datadog.yaml porte otelcollector.enabled: true, et /etc/datadog-agent/otel-config.yaml sert de configuration de départ. Après toute modification de ces fichiers, redémarrez l’Agent. Je n’ai pas relevé la commande de redémarrage sur cette page : reportez-vous à la documentation de votre distribution. La page d’installation Linux ne précise pas non plus si cette voie est en preview ; ce point reste donc non vérifié.
Envoyer la télémétrie d’une application vers DDOT
Dans le Deployment de l’application, pointez le SDK OpenTelemetry vers l’IP du nœud. La documentation donne ces variables d’environnement.

Pour le « unified service tagging », définissez OTEL_SERVICE_NAME et OTEL_RESOURCE_ATTRIBUTES avec service.version et deployment.environment.name. La documentation déconseille de les combiner avec les labels Kubernetes propres à Datadog, car cela crée des tags en double.
Comment vérifier que ça fonctionne
Sur Linux, sudo datadog-agent status doit afficher une section « OTel Agent » avec l’état Running. Sur Kubernetes, la page n’indique aucune commande de vérification ; elle renvoie vers l’interface Datadog : Fleet Automation (configuration de l’Agent et du Collector), Infrastructure Host List, Logs Explorer, Trace Explorer et le tableau de bord de santé du Collector OTel. Après redéploiement de l’application, des traces et des métriques doivent y apparaître.
Ce que DDOT change pour une équipe SRE
- Moins de pièces à exploiter : un seul DaemonSet porte l’Agent et le Collector, au lieu de deux cycles de mise à jour. La contrepartie est un couplage : la version du Collector suit celle de l’Agent.
- Un catalogue de composants limité : tout ce qui sort de la liste exige la procédure de composants personnalisés. Comparez avec votre configuration actuelle avant de migrer.
- Des valeurs par défaut différentes : la page de migration prévient que les défauts de DDOT peuvent différer de ceux du Collector amont, par exemple pour
filelogreceiver. - Un coût à surveiller : la documentation rappelle que certaines options (APM, process,
podLabelsAsTags) peuvent entraîner des frais ou influencer les métriques personnalisées. Je ne cite aucun tarif ; consultez la page officielle de Datadog.
Le lien avec OpenTelemetry reste réel : le receiver OTLP, les processors et l’exporter viennent de l’écosystème OpenTelemetry, et vos applications gardent leurs SDK standards. Avec Dynatrace, la logique est différente : on peut aussi envoyer de l’OTLP vers un Collector, comme décrit dans le Collector OpenTelemetry sur Kubernetes. Je n’affirme aucune intégration entre DDOT et Dynatrace, car la documentation consultée n’en décrit pas. Pour l’échantillonnage, voir le tail sampling avec OpenTelemetry.
Questions fréquentes
DDOT remplace-t-il le Collector OpenTelemetry amont ?
Il peut le remplacer si votre configuration n’utilise que les composants inclus. La documentation propose un guide de migration pas à pas. Sinon, il faut ajouter des composants personnalisés ou garder le Collector amont.
DDOT fonctionne-t-il sur Linux et sur Kubernetes ?
Oui, la documentation décrit l’installation sur Kubernetes (DaemonSet) et sur des hôtes Linux. La page de migration signale qu’EKS Fargate n’est pas pris en charge.
Faut-il utiliser DDOT si on envoie déjà de l’OTLP à Datadog ?
Pas nécessairement. Le choix dépend de votre besoin de pipelines locaux et de votre appétit pour un Collector couplé à l’Agent. Pour comparer les autres chemins d’envoi, voir OpenTelemetry et Prometheus.
Conclusion
DDOT apporte un Collector OpenTelemetry au sein de l’Agent Datadog, avec un catalogue de composants défini et deux modes d’installation documentés. Vérifiez d’abord vos composants, testez sur un nœud, puis migrez. Références officielles : DDOT Collector, installation Kubernetes, installation Linux et guide de migration.
span.observer est un blog indépendant, non affilié à Dynatrace LLC ni à Datadog Inc. Datadog et DDOT sont des marques de leur propriétaire. Les exemples viennent de la documentation officielle consultée le 30 octobre 2026 : vérifiez-les pour votre version.