Présentation

La configuration à distance vous permet de définir dynamiquement les taux d’échantillonnage par service et par nom de ressource, depuis le Datadog UI, sans avoir à redéployer votre service.

Prérequis

• Datadog Agent 7.41.1 ou version ultérieure.
• Remote Configuration activée pour votre Agent.
• APM Remote Configuration Write permissions. Si vous ne disposez pas de ces autorisations, demandez à votre administrateur Datadog de les mettre à jour depuis les paramètres de votre organisation.

Version de la bibliothèque de tracing

Vous trouverez ci-dessous la version minimale du SDK requise pour cette fonctionnalité :

Consultez les taux d’échantillonnage par ressource sur la page Ingestion Control

Pour voir les taux d’échantillonnage configurés par ressource, accédez au résumé de l’ingestion de service Service Ingestion summary dans les Ingestion controls. Le tableau répertorie le taux d’échantillonnage appliqué par ressource du service.

• La colonne Ingested bytes affiche les octets ingérés à partir des spans du service et de la ressource, tandis que la colonne Downstream bytes affiche les octets ingérés à partir des spans où la décision d’échantillonnage est prise à partir de ce service et de cette ressource, y compris les octets provenant des services en aval dans la chaîne d’appel.
• La colonne Configuration indique où le taux d’échantillonnage de la ressource est appliqué :
  • Automatic si le default head-based sampling mechanism de l’Agent s’applique.
  • Local Configured si une règle d’échantillonnage a été définie localement dans le SDK.
  • Remote Configured si une règle d’échantillonnage à distance a été définie depuis l’interface utilisateur Datadog. Pour savoir comment configurer des règles d’échantillonnage depuis la page Ingestion Control, lisez la section sur la configuration à distance des règles d’échantillonnage.

Configurer à distance les règles d’échantillonnage pour le service

Pour configurer les taux d’échantillonnage pour le service par nom de ressource :

1. Cliquez sur Manage Ingestion rate. Si l’option de configuration à distance est désactivée, assurez-vous que les prérequis listés sont tous remplis.

2. Cliquez sur Add new rule pour définir les taux d’échantillonnage pour certaines ressources. Les règles d’échantillonnage utilisent les motifs glob pour la correspondance, vous pouvez donc utiliser des caractères génériques (*) pour faire correspondre plusieurs ressources en même temps.
3. Cliquez sur Apply pour enregistrer la configuration.

La configuration devrait prendre effet en moins d’une minute. Vous pouvez observer les changements de configuration depuis le Live Search Explorer.

Depuis le Service Ingestion Summary, les ressources pour lesquelles les taux d’échantillonnage sont appliqués à distance devraient apparaître comme Remote Configured dans la colonne Configuration.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Mécanismes d'ingestionDOCUMENTATION Page Ingestion ControlDOCUMENTATION Optimiser le traçage distribué : bonnes pratiques pour respecter le budget et capturer les traces critiquesARCHITECTURE CENTER