Présentation

Datadog fournit des endpoints d’ingestion OTLP dédiés pour les plateformes gérées, vous permettant d’envoyer des traces, des métriques et des logs directement vers Datadog avec une configuration minimale. Chaque plateforme prise en charge possède son propre sous-domaine OTLP (par exemple, cloudflare.integrations.otlp.datadoghq.com). Ces endpoints dédiés permettent à Datadog d’identifier la source du trafic et d’appliquer un traitement et une attribution spécifiques à la plateforme. L’endpoint OTLP générique suppose qu’un host est présent, ce qui peut entraîner un comportement inattendu pour le trafic des plateformes gérées.

Utilisez cette option lorsque vous exécutez des charges de travail sur une plateforme gérée où l’installation d’un Datadog Agent ou d’un OpenTelemetry Collector n’est pas réalisable. Si votre plateforme ne figure pas dans le tableau ci-dessous et que vous utilisez des services de calcul serverless AWS, Azure ou GCP, consultez Serverless.

Pour des recommandations sur les noms d’hôte pour l’ingestion directe d’OTLP, consultez Hostname and Tagging.

Chaque endpoint prend en charge les chemins de signal suivants :

Pour une configuration spécifique aux signaux (traduction de métriques, traitement de logs), consultez les pages des endpoints Logs et Metrics.

Configuration

Pour envoyer des données OTLP vers Datadog via un endpoint de plateforme gérée, configurez votre exportateur OpenTelemetry avec les variables d’environnement suivantes. Remplacez {platform} par le sous-domaine de votre plateforme issu du tableau des plateformes prises en charge.

export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://{platform}.integrations.otlp."
export OTEL_EXPORTER_OTLP_HEADERS="dd-api-key=${DD_API_KEY}"

Pour envoyer uniquement des traces :

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://{platform}.integrations.otlp./v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY}"

Plateformes prises en charge

Tous les endpoints suivent le modèle https://{subdomain}.integrations.otlp./.

Pour activer l’exportation OTLP depuis une plateforme gérée non listée ci-dessus, contactez votre Customer Success Manager.

Limitations

Aucun enrichissement de métadonnées

Sans Collector ou Agent, la télémétrie n’est pas enrichie avec les métadonnées du host. Les fonctionnalités qui dépendent de ces métadonnées (par exemple, la liste des hosts d’infrastructure) sont indisponibles. Consultez la liste de compatibilité OpenTelemetry pour obtenir la liste complète des fonctionnalités concernées.

Normalisation limitée

Certains traitements de signal qu’un collecteur ou un Agent effectue automatiquement ne se produisent pas avec l’ingestion directe. Par exemple, la conversion de métriques cumulatives en delta nécessite un composant avec état. Si votre plateforme exporte des métriques cumulatives, configurez votre SDK ou votre pipeline pour exporter une temporalité delta.

Métriques de trace

Les métriques de trace sont calculées par défaut pour les endpoints de plateforme gérés. Les plateformes gérées peuvent échantillonner le trafic avant l’exportation, ce qui peut affecter la précision des métriques de trace.

Échantillonnage

Les contrôles d’échantillonnage disponibles dans le Collecteur (échantillonnage basé sur le suivi, échantillonnage probabiliste) ne sont pas disponibles avec l’ingestion directe. Les plateformes gérées peuvent appliquer leur propre échantillonnage avant l’exportation.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Compatibilité OpenTelemetry dans DatadogDOCUMENTATION Endpoint d'ingestion OTLP DatadogDOCUMENTATION