Métricas de traza

Documentos > APM > Métricas de APM > Métricas de traza

Esta traducción no está actualizada. Para consultar la última versión en inglés, haz clic aquí

Resumen

Las métricas de trazado de la aplicación se recopilan después de que habilite la recopilación de trazas e instrumente su aplicación.

Estas métricas capturan el conteo de solicitudes, el conteo de errores y las medidas de latencia. Se calculan en base al 100% del tráfico de la aplicación, independientemente de cualquier configuración de muestreo de ingestión de trazas. Asegúrese de tener visibilidad completa del tráfico de su aplicación utilizando estas métricas para detectar posibles errores en un servicio o recurso, y creando tableros, seguimientos y SLOs.

Nota: Si sus aplicaciones están instrumentadas con bibliotecas de OpenTelemetry, y el muestreo está configurado a nivel de SDK, las métricas APM se calculan en base al conjunto de datos muestreados. Sin embargo, si el muestreo está configurado a nivel del recolector de OpenTelemetry y el procesador de muestreo está aguas arriba del conector de Datadog, las métricas APM se calculan en base al 100% del tráfico de la aplicación.

Las métricas de traza se generan para tramos de entrada de servicio y para ciertas operaciones, dependiendo del lenguaje de integración. Por ejemplo, la integración de Django produce métricas de traza a partir de tramos que representan varias operaciones (1 tramo raíz para la solicitud de Django, 1 para cada middleware y 1 para la visualización).

El espacio de nombres de métricas de traza está formateado como:

trace.<SPAN_NAME>.<METRIC_SUFFIX>

Con las siguientes definiciones:

<SPAN_NAME>: El nombre de la operación o span.name (ejemplos: redis.command, pylons.request, rails.request, mysql.query).
<METRIC_SUFFIX>: El nombre de la métrica (ejemplos: hits, errors, apdex, duration). Vea la sección a continuación.
<TAGS>: Etiquetas de métricas de traza, las etiquetas posibles son: env, service, version, resource, http.status_code, http.status_class, rpc.grpc.status_code(requiere Datadog Agent v7.65.0+) y etiquetas del Datadog Agent (incluyendo el host y etiquetas primarias adicionales).; Nota: Otras etiquetas establecidas en tramos no están disponibles como etiquetas en métricas de traza.

Sufijo de métrica

Hits

trace.<SPAN_NAME>.hits: Prerequisito: Esta métrica existe para cualquier servicio APM.
Descripción: Representa el conteo de spans creados con un nombre específico (por ejemplo, redis.command, pylons.request, rails.request o mysql.query).
Tipo de métrica: COUNT.
Etiquetas: env, service, version, resource, resource_name, http.status_code, rpc.grpc.status_code, todas las etiquetas de host del Datadog Host Agent, y etiquetas primarias adicionales.
trace.<SPAN_NAME>.hits.by_http_status: Prerequisito: Esta métrica existe para servicios APM HTTP/WEB si existen metadatos HTTP.
Descripción: Representa el conteo de hits para un tramo dado, desglosado por código de estado HTTP.
Tipo de métrica: COUNT.
Etiquetas: env, service, version, resource, resource_name, http.status_class, http.status_code, todas las etiquetas de host del Agente de Host de Datadog, y etiquetas primarias adicionales.

Distribución de latencia

trace.<SPAN_NAME>: Prerequisito: Esta métrica existe para cualquier servicio APM.
Descripción: Representa la distribución de latencia para todos los servicios, recursos y versiones en diferentes entornos y etiquetas primarias adicionales. Recomendado para todos los casos de uso de medición de latencia.
Tipo de métrica: DISTRIBUTION.
Etiquetas: env, service, version, resource, resource_name, http.status_code, rpc.grpc.status_code, synthetics, y etiquetas primarias adicionales.

Errores

trace.<SPAN_NAME>.errors: Prerequisito: Esta métrica existe para cualquier servicio APM.
Descripción: Representa el conteo de errores para un tramo dado.
Tipo de métrica: COUNT.
Etiquetas: env, service, version, resource, resource_name, http.status_code, rpc.grpc.status_code, todas las etiquetas de host del Agente de Host de Datadog, y etiquetas primarias adicionales.
trace.<SPAN_NAME>.errors.by_http_status: Requisito previo: Esta métrica existe para cualquier servicio APM.
Descripción: Representa el conteo de errores para un tramo dado.
Tipo de métrica: COUNT.
Etiquetas: env, service, version, resource, http.status_class, http.status_code, todas las etiquetas de host del Datadog Host Agent, y etiquetas primarias adicionales.

Apdex

trace.<SPAN_NAME>.apdex: Prerequisito: Esta métrica existe para cualquier servicio APM basado en HTTP o web.
Descripción: Mide el puntaje Apdex para cada servicio web.
Tipo de métrica: GAUGE.
Etiquetas: env, service, version, resource / resource_name, synthetics, y etiquetas primarias adicionales.

Métricas heredadas

Las siguientes métricas se mantienen para compatibilidad hacia atrás. Para todos los casos de uso de medición de latencia, Datadog recomienda encarecidamente usar métricas de distribución de latencia en su lugar.

Duración (Heredada)

Importante: Las métricas de duración se mantienen solo para compatibilidad hacia atrás. Para todos los casos de uso de medición de latencia, Datadog recomienda encarecidamente usar métricas de distribución de latencia en su lugar, ya que proporcionan mejor precisión para cálculos de percentiles y análisis de rendimiento general.

trace.<SPAN_NAME>.duration: Prerequisito: Esta métrica existe para cualquier servicio APM.
Descripción: Mide el tiempo total para una colección de tramos dentro de un intervalo de tiempo, incluyendo tramos hijos vistos en el servicio de recolección. Para la mayoría de los casos de uso, Datadog recomienda usar la distribución de latencia para el cálculo de la latencia promedio o percentiles. Para calcular la latencia promedio con filtros de etiquetas de host, puede usar esta métrica con la siguiente fórmula:
sum:trace.<SPAN_NAME>.duration{<FILTER>}.rollup(sum).fill(zero) / sum:trace.<SPAN_NAME>.hits{<FILTER>}.rollup(sum).fill(zero)
Esta métrica no soporta agregaciones de percentiles. Lea la sección Distribución de Latencia para más información.
Tipo de métrica: GAUGE.
Etiquetas: env, service, resource, http.status_code, todas las etiquetas de host del Datadog Host Agent, y etiquetas primarias adicionales.

Duración por (Heredada)

trace.<SPAN_NAME>.duration.by_http_status: Requisito previo: Esta métrica existe para servicios de APM HTTP/WEB si existen metadatos http.
Descripción: Mide el tiempo total para una colección de tramos para cada estado HTTP. Específicamente, es la participación relativa del tiempo gastado por todos los tramos durante un intervalo y un estado HTTP dado, incluyendo el tiempo gastado esperando en procesos hijos.
Tipo de métrica: GAUGE.
Etiquetas: env, service, resource, http.status_class, http.status_code, todas las etiquetas de servidor del Datadog Host Agent, y etiquetas primarias adicionales.

Impacto del muestreo en las métricas de traza

En la mayoría de los casos, las métricas de traza se calculan en función de todo el tráfico de la aplicación. Sin embargo, con ciertas configuraciones de muestreo de ingestión de trazas, las métricas de traza representan solo un subconjunto de todas las solicitudes.

Muestreo del lado de la aplicación

Algunos SDKs admiten el muestreo del lado de la aplicación, lo que reduce el número de tramos antes de que se envíen al Agente de Datadog. Por ejemplo, el SDK de Ruby ofrece muestreo del lado de la aplicación para reducir la sobrecarga de rendimiento. Sin embargo, esto puede afectar las métricas de traza, ya que el Agente de Datadog necesita todos los tramos para calcular métricas precisas.

Muy pocos SDKs admiten esta configuración y, en general, no se recomienda su uso.

Muestreo de OpenTelemetry

Los mecanismos nativos de muestreo del SDK de OpenTelemetry reducen el número de tramos enviados al recolector de Datadog, lo que resulta en métricas de traza muestreadas y potencialmente inexactas.