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.

Durée

Cette méthode d'utilisation des métriques de trace est obsolète. À la place, nous vous conseillons de tracer les métriques de distribution avec DDSketch.

trace.<NOM_SPAN>.duration: Prérequis : cette métrique existe pour tous les services APM.
Description : [OBSOLÈTE] Correspond à la durée totale mesurée pour un groupe de spans dans un intervalle de temps, y compris les spans enfants détectées par le service de collecte. Cette métrique est utilisée pour générer le graphique « % exec time for downstream services » (% de temps d’exécution pour les services en aval). Le fait de diviser trace.<NOM_SPAN>.duration par trace.<NOM_SPAN>.hits, peut donner une latence moyenne, mais cette méthode de calcul de la latence moyenne n’est pas recommandée. Consultez plutôt la section Distribution de la latence pour effectuer ce calcul.
Type de métrique : GAUGE.
Tags : env, service, resource, http.status_code, tous les tags de host de l’Agent pour host Datadog et le deuxième tag primaire.

Duration by

Cette méthode d'utilisation des métriques de trace est obsolète. À la place, nous vous conseillons de tracer les métriques de distribution avec DDSketch.

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.