Métriques d'application de tracing

Métriques d'application de tracing

Présentation

Les métriques d’application de tracing sont collectées après l'activation de la collecte de traces et l'instrumentation de votre application. Ces métriques sont disponibles pour les dashboards et les monitors. Le format de l’espace de nommage des métriques de traces est le suivant :

  • trace.<NOM_SPAN>.<SUFFIXE_MÉTRIQUE>
  • trace.<NOM_SPAN>.<SUFFIXE_MÉTRIQUE>.<2E_TAG_PRIM>_service

Les paramètres sont définis comme suit :

<NOM_SPAN>
Le nom de l’opération ou span.name (par exemple : redis.command, pylons.request, rails.request, mysql.query).
<SUFFIXE_MÉTRIQUE>
Le nom de la métrique (par exemple : duration, hits, span_count). Référez-vous à la section ci-dessous.
<2E_TAG_PRIM>
Si le nom de la métrique prend en compte le deuxième tag primaire, ce tag fait partie du nom de la métrique.
<TAGS>
Les tags des métriques de trace. Voici la liste des tags pris en charge : env, service, version, resource, sublayer_type, sublayer_service, http.status_code, http.status_class et les tags de l’Agent Datadog (y compris le tag host et le deuxième tag primaire). Remarque : les tags définis sur des spans ne sont pas pris en compte et ne seront pas disponibles en tant que tags pour vos métriques de trace.

Suffixe des métriques

Hits

trace.<NOM_SPAN>.hits
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente le nombre de hits d’une span donnée.
Type de métrique : COUNT.
Tags : env, service, version, resource, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.hits.by_http_status
Prérequis : cette métrique est disponible pour les services HTTP/WEB de l’APM tant que des métadonnées HTTP sont fournies.
Description : elle représente le nombre de hits d’une span donnée, avec une répartition par code de statut HTTP.
Type de métrique : COUNT.
Tags : env, service, version, resource, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.

Agrégation par centile

trace.<NOM_SPAN>.duration.by.resource_<2E_TAG_PRIM>_service.<AGRÉGATION_CENTILE>
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle mesure la durée totale de traitement par ressource, service et deuxième tag primaire.
Type de métrique : GAUGE.
Agrégations par centile : 100p, 50p, 75p, 90p, 95p et 99p.
Tags : env, service, resource et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by.resource_service.<AGRÉGATION_CENTILE>
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle mesure la durée totale de traitement pour chaque combinaison de ressource et de service.
Type de métrique : GAUGE.
Agrégations par centile : 100p, 50p, 75p, 90p, 95p et 99p.
Tags : env, service et resource.
trace.<NOM_SPAN>.duration.by.<2E_TAG_PRIM>_service.<AGRÉGATION_CENTILE>
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle mesure la durée totale de traitement pour chaque combinaison de deuxième tag primaire et de service.
Type de métrique : GAUGE.
Agrégations par centile : 100p, 50p, 75p, 90p, 95p et 99p.
Tags : env, service et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by.service.<AGRÉGATION_CENTILE>
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente la durée d’une span spécifique. Elle permet de surveiller la latence et de calculer des mesures telles que le temps d’attente moyen constaté par un utilisateur, ou le temps d’attente constaté par les 1 % d’utilisateurs les plus lents.
Type de métrique : GAUGE.
Agrégations par centile : 100p, 50p, 75p, 90p, 95p et 99p
Tags : env et service.

Errors

trace.<NOM_SPAN>.errors
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente le nombre d’erreurs d’une span donnée.
Type de métrique : COUNT.
Tags : env, service, version, resource, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.errors.by_http_status
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente le nombre d’erreurs d’une span donnée.
Type de métrique : COUNT.
Tags : env, service, version, resource, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.

Span count

Remarque : cet espace de nommage est obsolète.

trace.<NOM_SPAN>.span_count
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente le nombre de spans recueillies lors d’un intervalle donné.
Type de métrique : COUNT.
Tags : env, service, resource, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.span_count.by_http_status
Prérequis : cette métrique est disponible pour les services HTTP/WEB de l’APM tant que des métadonnées HTTP sont fournies.
Description : elle représente le nombre de spans recueillies lors d’un intervalle donné, réparties par statut HTTP.
Type de métrique : COUNT.
Tags : env, service, resource, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.

Duration

trace.<NOM_SPAN>.duration
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle correspond à la durée totale mesurée pour un groupe de spans. Plus précisément, il s’agit de la durée de traitement totale mesurée pour toutes les spans lors d’un intervalle donné, y compris le temps passé à attendre les processus enfant.
Type de métrique : GAUGE.
Tags : env, service, resource, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.

Duration by

trace.<NOM_SPAN>.duration.by_http_status
Prérequis : cette métrique est disponible pour les services HTTP/WEB de l’APM tant que des métadonnées HTTP sont fournies.
Description : elle correspond à la durée totale mesurée pour un groupe de spans, pour chaque statut HTTP. Plus précisément, il s’agit de la proportion de la durée de traitement mesurée pour toutes les spans lors d’un intervalle donné et pour un statut HTTP précis, y compris le temps passé à attendre les processus enfant.
Type de métrique : GAUGE.
Tags : env, service, resource, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by_service
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle mesure la durée réelle totale du traitement pour chaque service (c’est-à-dire, en excluant le temps passé à attendre les processus enfant).
Type de métrique : GAUGE.
Tags : env, service, resource, sublayer_service, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by_type
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle mesure la durée réelle totale du traitement pour chaque type de service.
Type de métrique : GAUGE.
Tags : env, service, resource, sublayer_type, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by_type.by_http_status
Prérequis : cette métrique est disponible pour les services HTTP/WEB de l’APM tant que des métadonnées HTTP sont fournies.
Description : elle mesure la durée réelle totale du traitement pour chaque type de service et statut HTTP.
Type de métrique : GAUGE.
Tags : env, service, resource, sublayer_type, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.
trace.<NOM_SPAN>.duration.by_service.by_http_status
Prérequis : cette métrique est disponible pour les services HTTP/WEB de l’APM tant que des métadonnées HTTP sont fournies.
Description : elle mesure la durée réelle totale du traitement pour chaque service et statut HTTP.
Type de métrique : GAUGE.
Tags : env, service, resource, sublayer_service, http.status_class, http.status_code, tous les tags de host de l’Agent de host Datadog et le deuxième tag primaire.

Apdex

trace.<NOM_SPAN>.apdex
Prérequis : cette métrique est disponible pour tous les services HTTP/WEB de l’APM.
Description : elle mesure le score Apdex pour chaque service Web.
Type de métrique : GAUGE.
Tags : env, service, resource / resource_name, version, synthetics et le deuxième tag primaire.

Les métriques Apdex suivantes sont désormais obsolètes.

trace.<NOM_SPAN>.apdex.by.resource_<2E_TAG_PRIM>_service
Prérequis : cette métrique est disponible pour tous les services HTTP/WEB de l’APM.
Description : elle mesure le score Apdex pour toutes les combinaisons de ressources, deuxièmes tags primaires et services.
Type de métrique : GAUGE.
Tags : env, service, resource/resource_name et le deuxième tag primaire.
trace.<NOM_SPAN>.apdex.by.resource_service
Prérequis : cette métrique est disponible pour tous les services HTTP/WEB de l’APM.
Description : elle mesure le score Apdex de chaque combinaison de ressources et de services Web.
Type de métrique : GAUGE.
Tags : env, service et resource/resource_name.
trace.<NOM_SPAN>.apdex.by.<2E_TAG_PRIM>_service
Prérequis : cette métrique est disponible pour tous les services HTTP/WEB de l’APM.
Description : elle mesure le score Apdex pour chaque combinaison de deuxième tag primaire et de service Web.
Type de métrique : GAUGE.
Tags : env, service et le deuxième tag primaire.
trace.<NOM_SPAN>.apdex.by.service
Prérequis : cette métrique est disponible pour tous les services HTTP/WEB de l’APM.
Description : elle mesure le score Apdex pour chaque service Web.
Type de métrique : GAUGE.
Tags : env et service.

Pour aller plus loin