Le type de soumission de métrique 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 vers une base de données ou le nombre total de requêtes vers un endpoint. Ce nombre d’événements peut augmenter ou diminuer au fil du temps ; il n’est pas strictement croissant.

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

Le type de soumission de métrique 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, comme la fréquence des connexions établies vers une base de données ou le flux de requêtes effectuées vers un endpoint.

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

Le type de soumission de métrique GAUGE représente un instantané des événements dans un intervalle de temps. Cette valeur instantanée représentative est la dernière valeur soumise à l’Agent pendant un intervalle de temps. Une GAUGE peut être utilisée pour prendre une mesure de quelque chose qui fait rapport en continu, comme l’espace disque disponible ou la mémoire utilisée.

Le type de soumission de métrique 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 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 l’Agent par défaut :

<METRIC_NAME>.avg

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

<METRIC_NAME>.count

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

<METRIC_NAME>.median

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

<METRIC_NAME>.95percentile

Représente le 95e percentile de ces X valeurs dans l’intervalle de temps.
Type dans l’application Datadog : GAUGE

<METRIC_NAME>.max

Représente la valeur maximale de ces X valeurs envoyées pendant l’intervalle de temps.
Type dans l’application 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 centiles que vous souhaitez envoyer à Datadog avec le paramètre histogram_percentiles dans votre datadog.yaml fichier de configuration. Par défaut, seule la 95percentile est envoyée à Datadog.

Le type de soumission de métrique 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 hosts sous-jacents.

Contrairement au type de soumission de métrique HISTOGRAM, qui agrège les valeurs sur l’Agent durant un intervalle de temps donné, une métrique DISTRIBUTION envoie toutes les données brutes à Datadog pendant un intervalle de temps. Les agrégations se produisent côté serveur. Comme 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 centiles
• Personnalisation du marquage

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 les requêtes :

avg:<METRIC_NAME>

Représente la moyenne de ces X valeurs dans l’intervalle de temps.
Type dans l’application 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 dans l’application Datadog: COUNT

max:<METRIC_NAME>

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

min:<METRIC_NAME>

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

sum:<METRIC_NAME>

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

Remarque : Bien que les différentes agrégations des valeurs de métriques de distribution soient représentées en tant que GAUGE ou 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 host exécutant le Datadog Agent. Cet host émet les valeurs suivantes dans un intervalle de temps de vidage : [1,1,1,2,2,2,3,3].

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

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

L’Agent ajoute 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 en tant que valeur de la métrique RATE.

Supposons que vous soumettiez une métrique GAUGE, temperature, depuis un seul host exécutant le Datadog Agent. Cet host é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, en tant que 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] dans un intervalle de vidage 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 vidage 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]. Sur 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 centiles

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

Des agrégations de centiles 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 ajoutiez des agrégations de centiles à votre métrique de distribution dans l’application, les cinq agrégations supplémentaires suivantes seraient disponibles pour la requête :

C’est-à-dire que pour une métrique de distribution avec des agrégations de centiles ajoutées au cours d’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 de métriques de distribution soient représentées en tant que GAUGE ou COUNT dans l’application, la métrique elle-même conserve le type DISTRIBUTION.

Personnalisation du tagging

Cette fonctionnalité vous permet de contrôler le tagging pour les métriques où une granularité au niveau du host n’est pas nécessaire. En savoir plus sur Metrics without Limits™.

Remarque : L’exclusion de tags n’est pas prise en charge dans la personnalisation des tags basée sur une liste d’autorisation. L’ajout de tags 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’un type de métrique 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 comptes 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 type RATE via DogStatsD, soumettez soit une métrique [COUNT][16], soit une métrique [HISTOGRAM][18]. Les valeurs des métriques 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 :

La soumission d’une métrique TIMER au Datadog Agent équivaut à la soumission d’un type de métrique HISTOGRAM dans DogStatsD (à ne pas confondre avec les timers dans le 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 le temps nécessaire pour rendre entièrement une page.

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

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