Présentation
Les métriques Distribution agrègent les valeurs envoyées par plusieurs hosts lors d’un intervalle de transmission afin de mesurer les distributions statistiques dans l’ensemble de votre infrastructure.
Les distributions globales instrumentent des objets logiques, comme des services, indépendamment des hosts sous-jacents. Contrairement aux histogrammes, qui effectuent l’agrégation au niveau de l’Agent, les distributions globales envoient toutes les données brutes recueillies durant un intervalle de transmission. L’agrégation se fait côté serveur à l’aide de la structure de données DDSketch de Datadog.
Les distributions proposent des fonctionnalités de requête et des options de configuration avancées qui ne sont pas disponibles pour les autres types de métriques (count, rate, gauge, histogram) :
Calcul des agrégations par centile : les distributions sont stockées sous la forme de structures de données DDSketch représentant des données brutes sans agrégation. Ainsi, il est possible de calculer des agrégations par centile (p50, p75, p90, p95, p99, ou tout autre centile de votre choix avec jusqu’à deux décimales) sur l’ensemble des données brutes provenant de tous vos hosts. Ces agrégations vous permettent d’obtenir des informations inédites grâce aux requêtes. Exemples :
Centile unique sur un intervalle donné :
« Calculer le 99,9e centile du temps de chargement de mon application au cours de la semaine précédente. »
Seuils en centile pour les monitors de métrique :
« Recevoir une alerte lorsque le p99 de la latence des requêtes de mon application dépasse 200 ms lors des 5 dernières minutes. »
Requêtes avec seuil :
« Définir un SLO de 30 jours avec un objectif de traitement de 95 % des requêtes de mon service en moins de cinq secondes. »
Personnalisation du tagging : cette fonctionnalité vous permet de contrôler le schéma de tagging pour les métriques custom pour lesquelles une granularité au niveau des hosts n’est pas nécessaire (p. ex., les transactions par seconde pour un service de paiement).
Consultez la section Outils de développement pour découvrir les détails d’implémentation.
Remarque : étant donné que les distributions sont un nouveau type de métrique, elles doivent être instrumentées avec de nouveaux noms de métrique lors de leur envoi à Datadog.
Activer les requêtes avancées
Comme d’autres types de métriques, gauges ou histograms par exemple, les métriques de distribution disposent des agrégations suivantes : count, min, max, sum et avg. Les distributions sont initialement taguées de la même manière que d’autres métriques, avec des tags personnalisés définis dans le code. Elles sont ensuite résolues avec des tags de host, en fonction du host qui a transmis la métrique.
Vous pouvez toutefois activer, depuis la page Metrics Summary, les requêtes avancées afin de calculer par exemple des agrégations par centile globales et précises pour tous les tags interrogeables sur votre distribution. Vous bénéficiez ainsi des agrégations p50, p75, p90, p95 et p99 et des centiles définis de votre choix (avec jusqu’à deux décimales, par exemple 99,99). L’activation des requêtes avancées vous permet également d’utiliser des requêtes avec seuil.
Après avoir choisi d’appliquer des agrégations par centile sur une métrique de distribution, ces agrégations sont automatiquement disponibles dans l’interface de création de graphique :
Les agrégations par centile peuvent être ajoutées à différents widgets et générer des alertes :
Centile unique sur un intervalle donné
« Calculer le 99,9e centile du temps de requête de mon application au cours de la semaine précédente. »
- Seuils en centile pour les monitors de métrique
« Recevoir une alerte lorsque le p99 de la latence des requêtes de mon application dépasse 200 ms lors des 5 dernières minutes. »
Requêtes avec seuil
Les requêtes avec seuil sont disponibles en version bêta publique.
Lorsque vous activez le calcul précis de centiles globaux avec DDSketch sur vos métriques de distribution, vous accédez à une nouvelle fonctionnalité : les requêtes avec seuil. Cette nouveauté vous permet de compter le nombre de valeurs brutes des métriques de distribution lorsqu’elles dépassent un seuil numérique. Vous pouvez ainsi compter le nombre d’erreurs ou de violations en fonction d’un seuil numérique anormal sur des dashboards, ou encore définir des SLO visant à ce que 95 % des requêtes soient traitées en moins de 10 secondes au cours des 30 derniers jours.
Lorsque vous définissez des requêtes avec seuil pour des distributions en centiles, vous n’avez pas besoin de définir la valeur de votre seuil avant l’envoi des métriques. Vous êtes donc libre d’ajuster librement votre seuil dans Datadog.
Pour utiliser les requêtes avec seuil, procédez comme suit :
- Activez les centiles sur votre métrique de distribution depuis la page Metrics Summary.
- Représentez la métrique de distribution de votre choix à l’aide de l’agrégateur « count values… ».
- Définissez la valeur de votre seuil ainsi qu’un opérateur de comparaison.
De la même façon, vous pouvez créer un SLO basé sur des métriques à l’aide des requêtes avec seuil :
- Activez les centiles sur votre métrique de distribution depuis la page Metrics Summary.
- Créez un SLO basé sur des métriques et définissez le numérateur afin qu’il compte le nombre d’événements positifs, avec une requête sur la métrique de distribution de votre choix et l’agrégateur « count values… ».
- Définissez la valeur de votre seuil ainsi qu’un opérateur de comparaison.
Personnaliser le tagging
Les distributions vous permettent de contrôler le tagging pour les métriques custom pour lesquelles une granularité au niveau des hosts est inutile. Les configurations de tag correspondent à des listes de tags que vous souhaitez conserver.
Pour personnaliser le tagging :
- Cliquez sur le nom de la métrique de distribution custom dans le tableau Metrics Summary afin d’ouvrir le volet latéral comportant des détails sur la métrique.
- Cliquez sur le bouton Manage Tags pour ouvrir une fenêtre de configuration des tags.
- Cliquez sur l’onglet Custom… pour personnaliser les tags que vous souhaitez pouvoir utiliser pour la requête.
Remarque : la personnalisation de tags via cette liste ne permet pas d’exclure de tags. L’ajout de tags débutant par ! n’est pas accepté.
Événements d’audit
Toute modification apportée à une configuration de tag ou à une agrégation par centile entraîne la création dans l’Events Explorer d’un événement qui décrit la modification et indique l’utilisateur à son origine.
Si vous avez créé, modifié ou supprimé une configuration de tag sur une métrique de distribution, vous pouvez consulter des exemples des événements associés à l’aide de la recherche suivante :
https://app.datadoghq.com/event/stream?tags_execution=and&per_page=30&query=tags%3Aaudit%20status%3Aall%20priority%3Aall%20tag%20configuration
Si vous avez ajouté des agrégations par centile à une métrique de distribution ou que vous en avez supprimé de celle-ci, vous pouvez consulter des exemples des événements associés avec la recherche suivante :
https://app.datadoghq.com/event/stream?tags_execution=and&per_page=30&query=tags%3Aaudit%20status%3Aall%20priority%3Aall%20percentile%20aggregations
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
