Le type de soumission de métriques COUNT représente le nombre total d’occurrences d’événements dans un intervalle de temps. Un COUNT peut être utilisé pour suivre le nombre total de connexions établies à une base de données ou le nombre total de requêtes à un point de terminaison. Ce nombre d’événements peut s’accumuler ou diminuer au fil du temps—il n’est pas monotoniquement croissant.

Remarque : Un COUNT est différent du type de métrique RATE, qui représente le nombre d’occurrences d’événements normalisées par seconde compte tenu de l’intervalle de temps défini.

Le type de soumission de métriques RATE représente le nombre total d’occurrences d’événements par seconde dans un intervalle de temps. Un RATE peut être utilisé pour suivre la fréquence à laquelle quelque chose se produit — par exemple, le nombre de connexions établies à une base de données ou le flux de requêtes adressées à un point de terminaison.

Remarque : Un RATE est différent du type de soumission de métriques COUNT, qui représente le nombre total d’occurrences d’événements dans l’intervalle de temps donné.

Le type de soumission de métriques GAUGE représente un instantané d’événements dans un intervalle de temps. Cette valeur d’instantané représentative est la dernière valeur soumise à l’Agent pendant un intervalle de temps. Un GAUGE peut être utilisé pour mesurer quelque chose qui rapporte en continu—comme l’espace disque disponible ou la mémoire utilisée.

Le type de soumission de métriques HISTOGRAM représente la distribution statistique d’un ensemble de valeurs calculées côté Agent dans un intervalle de temps. Le type de métrique HISTOGRAM de Datadog est une extension du type de métrique de timing StatsD. L’Agent agrège les valeurs qui sont envoyées dans un intervalle de temps défini et produit différentes métriques qui représentent l’ensemble des valeurs.

Si vous envoyez X valeurs pour une métrique HISTOGRAM <METRIC_NAME> dans un intervalle de temps donné, les métriques suivantes sont produites par défaut par l’Agent :

<METRIC_NAME>.avg

Représente la moyenne de ces X valeurs dans l’intervalle de temps.
Type In-App de Datadog: GAUGE

<METRIC_NAME>.count

Représente le nombre de valeurs soumises pendant l’intervalle, X. L’Agent soumet ce nombre en tant que RATE afin qu’il affiche dans l’application la valeur de X/interval.
Type In-App de Datadog: RATE

<METRIC_NAME>.median

Représente la médiane de ces X valeurs dans l’intervalle de temps.
Type In-App de Datadog : GAUGE

<METRIC_NAME>.95percentile

Représente le 95ème percentile de ces X valeurs dans l’intervalle de temps.
Type In-App de Datadog : GAUGE

<METRIC_NAME>.max

Représente la valeur maximale de ces X valeurs envoyées pendant l’intervalle de temps.
Type In-App de Datadog : GAUGE

Remarques :

• Configurez les agrégations que vous souhaitez envoyer à Datadog avec le paramètre histogram_aggregates dans votre datadog.yaml fichier de configuration. Par défaut, seules les agrégations max, median, avg et count sont envoyées à Datadog. sum et min sont également disponibles.
• Configurez l’agrégation de percentile que vous souhaitez envoyer à Datadog avec le paramètre histogram_percentiles dans votre datadog.yaml fichier de configuration. Par défaut, seul le 95percentile est envoyé à Datadog.

Le type de soumission de métriques DISTRIBUTION représente la distribution statistique globale d’un ensemble de valeurs calculées sur l’ensemble de votre infrastructure distribuée dans un intervalle de temps. Une DISTRIBUTION peut être utilisée pour instrumenter des objets logiques, comme des services, indépendamment des hôtes sous-jacents.

Contrairement au type de métrique HISTOGRAM, qui agrège sur l’Agent pendant un intervalle de temps donné, une métrique DISTRIBUTION envoie toutes les données brutes pendant un intervalle de temps à Datadog. Les agrégations se produisent côté serveur. Parce que la structure de données sous-jacente représente des données brutes, non agrégées, les distributions offrent deux fonctionnalités majeures :

• Calcul des agrégations de percentile
• Personnalisation des tags

Si vous envoyez X valeurs pour une métrique DISTRIBUTION <METRIC_NAME> dans un intervalle de temps donné, les agrégations suivantes sont disponibles par défaut pour la requête :

avg:<METRIC_NAME>

Représente la moyenne de ces X valeurs dans l’intervalle de temps.
Type In-App de Datadog: GAUGE

count:<METRIC_NAME>

Représente le nombre de points soumis dans l’intervalle de temps, X. L’Agent l’envoie ensuite en tant que COUNT.
Type In-App Datadog: COUNT

max:<METRIC_NAME>

Représente la valeur maximale de ces X valeurs envoyées dans l’intervalle de temps.
Type In-App Datadog : GAUGE

min:<METRIC_NAME>

Représente la valeur minimale de ces X envoyées dans l’intervalle de temps.
Type In-App Datadog : GAUGE

sum:<METRIC_NAME>

Représente la somme de toutes les X valeurs envoyées dans l’intervalle de temps.
Type In-App Datadog : COUNT

Remarque : Bien que les différentes agrégations des valeurs des métriques de distribution soient représentées sous forme de GAUGE ou de COUNT dans l’application, la métrique elle-même conserve le type DISTRIBUTION.

Supposons que vous soumettiez une métrique COUNT, notifications.sent, depuis un seul hôte exécutant l’Agent Datadog. Cet hôte émet les valeurs suivantes dans un intervalle de temps de vidage : [1,1,1,2,2,2,3,3].

L’Agent additionne toutes les valeurs reçues dans un intervalle de temps. Ensuite, il soumet le nombre total, dans ce cas 15, comme valeur de la métrique COUNT.

Supposons que vous soumettiez une métrique RATE, queue_messages.rate, depuis un seul hôte exécutant l’Agent Datadog. Cet hôte émet les valeurs suivantes dans un intervalle de temps de vidage : [1,1,1,2,2,2,3,3].

L’Agent additionne toutes les valeurs reçues dans un intervalle de temps. Ensuite, il soumet le nombre total divisé par le nombre total de secondes dans cet intervalle de temps. Dans ce cas, si l’intervalle de vidage est de 10 secondes, la valeur soumise serait 1.5 comme valeur de la métrique RATE.

Supposons que vous soumettiez une métrique GAUGE, temperature, depuis un seul hôte exécutant l’Agent Datadog. Cet hôte émet les valeurs suivantes dans un intervalle de temps de vidage : [71,71,71,71,71,71,71.5].

L’Agent soumet le dernier nombre rapporté, dans ce cas 71.5, comme valeur de la métrique GAUGE.

Par exemple, supposons que vous soumettiez une métrique HISTOGRAM, request.response_time.histogram, depuis un serveur web qui rapporte les valeurs [1,1,1,2,2,2,3,3] pendant une période de flush de 10 secondes. Par défaut, l’Agent soumet les métriques suivantes à Datadog qui représentent la distribution statistique de ces valeurs dans cet intervalle de temps :

Supposons que vous soumettiez une métrique DISTRIBUTION, request.response_time.distribution, depuis deux serveurs web : webserver:web_1 et webserver:web_2. Supposons que dans un intervalle de temps de flush donné, webserver:web_1 rapporte la métrique avec les valeurs [1,1,1,2,2,2,3,3], et webserver:web_2 rapporte la même métrique avec les valeurs [1,1,2]. Au cours de cet intervalle de temps, les cinq agrégations suivantes représenteront la distribution statistique globale de toutes les valeurs collectées à partir des deux serveurs web :

Calcul des agrégations de percentile

Comme d’autres types de métriques, tels que GAUGE ou HISTOGRAM, le type de métrique DISTRIBUTION a les agrégations suivantes disponibles : count, min, max, sum, et avg. Les métriques de distribution sont initialement étiquetées de la même manière que les autres métriques (avec des étiquettes personnalisées définies dans le code).

Des agrégations de percentile supplémentaires (p50, p75, p90, p95, p99) peuvent être ajoutées aux métriques de distribution depuis le panneau latéral des détails de la métrique. Si vous deviez ajouter des agrégations de percentile à votre métrique de distribution dans l’application, les cinq agrégations supplémentaires suivantes sont disponibles pour la requête :

C’est-à-dire que pour une métrique de distribution avec des agrégations de percentile ajoutées pendant un intervalle de temps donné, les 10 agrégations suivantes sont disponibles : count, sum, min, max, avg, p50, p75, p90, p95, et p99.

Remarque : Bien que les différentes agrégations des valeurs métriques de distribution soient représentées sous forme de jauges ou de comptes dans l’application, la métrique elle-même conserve le type DISTRIBUTION.

Personnalisation des étiquettes

Cette fonctionnalité vous permet de contrôler l’étiquetage pour les métriques où la granularité au niveau de l’hôte n’est pas nécessaire. En savoir plus sur Metrics without Limits™.

Remarque : L’exclusion des étiquettes n’est pas prise en charge dans la personnalisation des étiquettes basée sur la liste autorisée. L’ajout d’étiquettes commençant par ! n’est pas accepté.

Envoyez vos métriques de type COUNT depuis l’une des sources suivantes :

Remarque : Lors de la soumission d’une métrique de type COUNT via DogStatsD, la métrique apparaît comme un RATE dans l’application pour garantir une comparaison pertinente entre différents agents. Par conséquent, les COUNT StatsD peuvent apparaître avec une valeur décimale dans Datadog (puisqu’ils sont normalisés sur un intervalle de temps pour rapporter des unités par seconde).

Envoyez vos métriques de type RATE depuis l’une des sources suivantes :

Remarque : Pour obtenir des métriques de RATE via DogStatsD, soumettez soit une métrique COUNT soit une métrique HISTOGRAM. Les valeurs de la métrique COUNT et <HISTOGRAM>.count sont des deltas normalisés dans le temps de la valeur de la métrique sur la période de flush de StatsD.

Envoyez vos métriques de type GAUGE depuis l’une des sources suivantes :

Envoyez vos métriques de type HISTOGRAM depuis l’une des sources suivantes :

Soumettre une métrique TIMER à l’Agent Datadog équivaut à soumettre une métrique de type HISTOGRAM via DogStatsD (à ne pas confondre avec les timers du StatsD standard). DogStatsD TIMER représente uniquement des données de durée. Par exemple, le temps qu’une section de code met à s’exécuter ou combien de temps il faut pour rendre complètement une page.

Envoyez vos métriques de type DISTRIBUTION depuis la source suivante :

Remarque: Bien que les différentes agrégations des valeurs métriques de distribution soient représentées sous forme de gauges ou de counts dans l’application, la métrique elle-même conserve le type DISTRIBUTION.