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 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 APM de type HTTP/WEB 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.

Distribution de la latence

trace.<NOM_SPAN>
Prérequis : cette métrique est disponible pour tous les services de l’APM.
Description : elle représente la distribution de latence pour l’ensemble des services, ressources et versions ainsi que tous les environnements et deuxièmes tags primaires.
Type de métrique : DISTRIBUTION.
Tags : env, service, resource, resource_name, version, synthetics et le deuxième tag primaire.

Errors

trace.<NOM_SPAN>.errors
Prérequis : cette métrique est disponible pour tous les services 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 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 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 APM de type HTTP/WEB 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 APM.
Description : elle correspond à la durée totale mesurée pour un groupe de spans. Plus précisément, il s’agit du temps de traitement total mesuré par toutes les spans dans 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 APM HTTP/WEB 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 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 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 APM de type HTTP/WEB 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 APM de type HTTP/WEB 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 APM de type HTTP/WEB.
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 APM de type HTTP/WEB.
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 APM de type HTTP/WEB.
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 APM de type HTTP/WEB.
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 APM de type HTTP/WEB.
Description : elle mesure le score Apdex pour chaque service Web.
Type de métrique : GAUGE.
Tags : env et service.

Pour aller plus loin