É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 :
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.
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 APM | Budget par volume de données |
|---|
| Avantages | S’adapte au nombre de hosts APM et au nombre de services intégrés ; vous n’avez à le configurer qu’une seule fois | Garantit que vous ne dépasserez jamais votre budget |
| Inconvénients | Ne 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 à Datadog | Vous 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 :
- Accédez à la page Ingestion Control.
- Cliquez sur Manage Adaptive Sampling Target.
- Choisissez une stratégie cible pour l’échantillonnage :
- Cliquez sur Apply.
Définissez le budget par nombre de hosts APM (Recommandé)
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.
Ce volume cible mensuel est recalculé toutes les 30 minutes.
Définissez le budget par volume de données
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.
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 :
- Accédez à la page Ingestion Control.
- Cliquez sur un service pour afficher le Service Ingestion Summary.
- Consultez le tableau listant les taux d’échantillonnage appliqués par ressource du service.
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 :
- Accédez à la page Ingestion Control.
- Cliquez sur un service pour afficher le Service Ingestion Summary.
- Cliquez sur Manage Ingestion Rate.
- Choisissez Datadog adaptive sampling rates comme stratégie d’échantillonnage de votre service.
- (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. - Cliquez sur Apply.
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.
Pour restreindre l’accès :
Remarque : Seuls les utilisateurs disposant de l’autorisation remote_config_write peuvent restreindre l’accès à la configuration d’échantillonnage adaptatif de services individuels.
Ouvrez la section Permissions dans le panneau latéral Ingestion Control du service.
Cliquez sur Restrict access.
Sélectionnez les équipes, les rôles ou les utilisateurs auxquels accorder l’accès.
Cliquez sur Add.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: