Échantillonnage adaptatif

Ce produit n'est pas pris en charge par le site Datadog que vous avez sélectionné. ().

Présentation

L’échantillonnage adaptatif Datadog vous aide à capturer des traces plus pertinentes tout en restant proche d’un budget spécifique (gigaoctets ingérés).

Lorsque vous choisissez l’échantillonnage adaptatif comme stratégie d’échantillonnage, vous sélectionnez un volume mensuel cible pour l’ingestion de traces pour un ou plusieurs services. Cela garantit que la consommation de ces services correspond au volume cible à la fin du mois, tout en conservant une visibilité sur leurs endpoints.

L’échantillonnage adaptatif utilise la configuration à distance ainsi que les mécanismes de règles d’échantillonnage existants pour ajuster dynamiquement les taux d’échantillonnage pour chaque combinaison d’environnement, de service et de ressource. Cela vous aide à :

  • Respectez votre budget mensuel spécifié.
  • Assurez la visibilité des services et endpoints à faible trafic en capturant au moins une trace pour chaque combinaison de service, ressource et environnement toutes les 5 minutes.

Pour configurer les services afin d’utiliser l’échantillonnage adaptatif, suivez les instructions ci-dessous.

Prérequis

  • Datadog Agent 7.53.0 ou version ultérieure.
  • Remote Configuration activée pour votre Agent.
  • APM Remote Configuration Write permission.
    Remarque : Si vous ne disposez pas de cette autorisation, demandez à votre administrateur Datadog de mettre à jour vos autorisations depuis les paramètres de votre organisation.

Versions de la bibliothèque de tracing

Le tableau suivant répertorie les versions minimales du SDK requises pour l’échantillonnage adaptatif :

LangageVersion minimale requise
Javav1.34.0
Gov1.68.0
Pythonv3.14.2
Rubyv2.0.0
Node.jsv5.16.0
.NETv2.54.0
C++/Proxiesv0.2.2
PHPv1.4.0
Rustv0.4.0

Limitations

Des limites s’appliquent aux combinaisons de services et d’environnements en fonction de la configuration d’échantillonnage :

Échantillonnage adaptatif

  • Le nombre maximal de service/env combinaisons intégrées à l’échantillonnage adaptatif est de 800.
  • Chaque paire service/env unique configurée pour l’échantillonnage adaptatif compte pour cette limite.

Configuration d’échantillonnage à distance

  • Le nombre maximal de service/env combinaisons utilisant une configuration d’échantillonnage à distance est de 1000.
  • Cette limite s’applique indépendamment du nombre de règles d’échantillonnage définies pour chaque service.
  • Chaque paire service/env unique avec échantillonnage à distance activé compte pour une unité dans cette limite.

Services utilisant à la fois l’échantillonnage adaptatif et à distance

  • Si une service/env combinaison utilise à la fois l’échantillonnage adaptatif et une configuration d’échantillonnage à distance, elle compte pour une unité dans chaque limite respective (une fois dans la limite de 800 pour l’échantillonnage adaptatif et une fois dans la limite de 1000 pour l’échantillonnage à distance).
  • Elle ne compte pas deux fois dans l’une ou l’autre des limites individuelles.

Configurez la cible d’échantillonnage adaptatif

Pour commencer avec l’échantillonnage adaptatif, vous devez d’abord choisir un paramètre de stratégie cible :

  • Set Budget by Number of APM Hosts : Configurez un budget proportionnel à votre allocation et au nombre de services intégrés (par exemple, en fonction du nombre de hosts APM)
  • Set Budget by Data Volume : Configurez une cible fixe en gigaoctets par mois
Budget par nombre de hosts APMBudget par volume de données
AvantagesS’adapte au nombre de hosts APM et au nombre de services intégrés ; vous n’avez à le configurer qu’une seule foisGarantit que vous ne dépasserez jamais votre budget
InconvénientsNe convient pas si vous souhaitez rester en dessous d’un volume spécifique, car il peut varier en fonction du nombre de hosts envoyant des données APM à DatadogVous devez modifier le budget à chaque fois que vous intégrez un nouveau service à l’échantillonnage adaptatif

Pour définir l’objectif mensuel d’échantillonnage adaptatif :

  1. Accédez à la page Ingestion Control.
  2. Cliquez sur Manage Adaptive Sampling Target.
    Appel à l'action pour définir l'objectif d'échantillonnage adaptatif
  3. Choisissez une stratégie cible pour l’échantillonnage :
  4. Cliquez sur Apply.
Définition de l'objectif basée sur un pourcentage :

Définissez votre objectif mensuel en pourcentage de votre allocation. En bas de la page, une explication plus complète vous est fournie sur la façon dont ce pourcentage est converti en un volume cible mensuel. Il s’agit du produit de :

  • Le global allotment : 150GB * number_of_APM_hosts + 50GB * number_of_traced_serverless_invocations (if applicable) + 10GB * number_of_fargate_tasks (if applicable)
  • Le percentage of allotment configuré ci-dessus
  • Le contribution of onboarded services à l’allocation. Par exemple, si les services intégrés à l’échantillonnage adaptatif contribuent à 10 % du volume total ingéré, Datadog cible 10 % de l’allocation globale. Ce nombre augmente avec le nombre de services intégrés.
Calcul de l'objectif basé sur un pourcentage :

Ce volume cible mensuel est recalculé toutes les 30 minutes.

Définissez le budget par volume de données

Définition de l'objectif basée sur le volume

Si vous configurez le premier service pour l’échantillonnage adaptatif, assurez-vous que l’objectif de volume d’ingestion est >0. Pour les services suivants, vous devez augmenter le budget alloué après l’intégration du nouveau service afin de prendre en compte le nouveau volume.

Le budget configuré est uniquement alloué aux services inscrits à l'échantillonnage adaptatif. Il n'inclut pas le volume ingéré provenant de services non inscrits à l'échantillonnage adaptatif, de règles d'échantillonnage locales ou d'autres mécanismes d'échantillonnage configurés localement dans l'Agent ou les SDK.

Configurez l’échantillonnage adaptatif pour un service

Affichez les taux d’échantillonnage par ressource pour un service

Avant de configurer l’échantillonnage adaptatif pour un service, vous pouvez afficher la configuration d’ingestion actuelle pour ce service.

Pour voir les taux d’échantillonnage configurés :

  1. Accédez à la page Ingestion Control.
  2. Cliquez sur un service pour afficher le Service Ingestion Summary.
  3. Consultez le tableau listant les taux d’échantillonnage appliqués par ressource du service.
Tableau des taux d'échantillonnage par ressource

Le tableau inclut :

  • Ingested bytes : Octets ingérés à partir des spans du service et de la ressource.
  • Downstream bytes : Octets ingérés à partir des spans où la décision d’échantillonnage commence à partir de ce service et de cette ressource, y compris les services en aval.
  • Configuration : Source du taux d’échantillonnage de la ressource :

Une fois qu’un service est intégré à l’échantillonnage adaptatif, les taux d’échantillonnage sont ajustés et recalculés toutes les 10 minutes.

Intégrez un service à l’échantillonnage adaptatif

Pour intégrer un service à l’échantillonnage adaptatif :

  1. Accédez à la page Ingestion Control.
  2. Cliquez sur un service pour afficher le Service Ingestion Summary.
  3. Cliquez sur Manage Ingestion Rate.
  4. Choisissez Datadog adaptive sampling rates comme stratégie d’échantillonnage de votre service.
  5. (Facultatif) Configurez des taux d’échantillonnage explicites pour des ressources spécifiques, pour lesquelles vous souhaitez capturer plus (par exemple, 100 % des endpoints GET /checkout) ou moins (par exemple, 0,1 % des requêtes /health) de données.
  6. Cliquez sur Apply.
Si l'application de cette configuration à distance est désactivée, assurez-vous que les exigences de Remote Configuration sont remplies.
Modale des paramètres d'échantillonnage adaptatif

La configuration devrait prendre effet en 5 à 6 minutes, le temps nécessaire pour que Datadog observe le modèle de trafic du service, calcule, puis applique les taux d’échantillonnage. Les ressources configurées à distance s’affichent sous la forme Configured Remote dans la colonne Configuration.

Autorisations

Par défaut, seuls les utilisateurs disposant du rôle Datadog Admin peuvent modifier les configurations d’échantillonnage adaptatif ou intégrer des services à l’échantillonnage adaptatif.

Si votre organisation utilise des rôles personnalisés, affectez votre utilisateur à un rôle personnalisé qui inclut les APM Remote Configuration Write et APM Service Ingest Write autorisations.

Restreindre l’accès

Utilisez les contrôles d’accès granulaires pour gérer qui peut modifier la configuration d’échantillonnage adaptatif d’un service. Vous pouvez restreindre l’accès en fonction des rôles, des équipes ou des utilisateurs individuels.

Modale de restriction des autorisations

Pour restreindre l’accès :

Ouvrir la modale de contrôle d'accès granulaire

Remarque : Seuls les utilisateurs disposant de l’autorisation remote_config_write peuvent restreindre l’accès à la configuration d’échantillonnage adaptatif de services individuels.

  1. Ouvrez la section Permissions dans le panneau latéral Ingestion Control du service.

  2. Cliquez sur Restrict access.

  3. Sélectionnez les équipes, les rôles ou les utilisateurs auxquels accorder l’accès.

  4. Cliquez sur Add.

Pour aller plus loin