Generar métricas personalizadas a partir de tramos y trazas

Métricas en función de tramos

Genera métricas personalizadas a partir de los tramos ingestados para realizar un seguimiento de las tendencias, alimentar dashboards y activar los monitores, incluso para los tramos y las trazas que no se conservan para el análisis completo de la traza.

Las métricas personalizadas se crean a partir de tramos ingestados por Datadog APM, independientemente de si un filtro de retención indexa esos tramos. Extrae valores numéricos de los tramos (como recuentos, duraciones o etiquetas personalizadas) o trazas (duración de extremo a extremo de la traza) y los almacena como métricas personalizadas de larga duración con una retención de 15 meses.

Notas:

  • Datadog genera automáticamente Métricas de trazas que capturan recuentos de solicitudes, tasas de error y distribuciones de latencia para el 100 % del tráfico de tu aplicación.
  • Los tramos disponibles para la generación de métricas personalizadas dependen de tus ajustes de control de ingesta de APM. Los tramos eliminados por muestreo o filtrado no pueden generar métricas.

Utiliza métricas personalizadas de tramos para:

  • Visibilidad detallada de la latencia a nivel de tramo, las tasas de error o el rendimiento a nivel de etiqueta.
  • Alimentación de monitores de anomalías o previsiones con métricas de baja latencia y alta resolución.
  • Extracción de señales clave para tendencias o alertas sin conservar la totalidad del tramo.

Cuándo utilizar métricas personalizadas a partir de trazas

Datadog permite generar métricas a partir de consultas de trazas.

Utiliza métricas personalizadas a partir de trazas para:

  • Métricas derivadas del contexto completo de la traza, como la duración total de la traza o las operaciones por traza.
  • Alerta sobre condiciones que requieren un conocimiento completo de la traza (por ejemplo, detección de consultas N+1 o patrones de fan-out).
  • Extracción de señales clave para tendencias o alertas sin conservar la totalidad de la traza.

Crear una métrica a partir de tramos o trazas

Cómo crear una métrica
  1. Ve a APM > Generate Metrics (Generar métricas).
  2. Haz clic en New Metric (Nueva métrica).
  3. Nombra tu métrica siguiendo la convención de nombres de métricas. No se permiten nombres de métricas que empiecen por trace.*.
  4. Selecciona el tipo de métrica: Spans (Tramos) o Traces (Trazas). Ambos utilizan la misma sintaxis de consulta que APM Search and Analytics.
  5. Define la consulta de métrica para filtrar e incluir solo los tramos o trazas que desees medir.
  6. Elige el valor a agregar:
    • Selecciona * para contar todos los tramos o trazas coincidentes.
    • Introduce un atributo numérico (por ejemplo, @cassandra_row_count) para agregar y realizar un seguimiento del recuento, el mínimo, el máximo, la suma o los percentiles.
  7. Establecer dimensiones de agrupación. Por defecto, las métricas no tienen etiquetas a menos que las añadas. Utiliza cualquier atributo o etiqueta de tramo para crear etiquetas de métrica.
  8. Obtén una vista previa del resultado para ver el impacto en tiempo real de tu consulta a través de la visualización de datos y la coincidencia de tramos o trazas en la vista previa en directo.
  9. Haz clic en Crear métrica.
Las métricas basadas en tramos se consideran métricas personalizadas y se facturan en consecuencia. Evita agrupar por atributos no limitados o de cardinalidad extremadamente alta, como marcas de tiempo, ID de usuario, ID de solicitud o ID de sesión, para no afectar a tu facturación.

Actualizar las métricas existentes

Editar una métrica existente

Tras crear una métrica, solo se pueden actualizar dos campos:

CampoMotivo
Flujo (stream) filtro de consultaCambia el conjunto de tramos coincidentes que se agregarán en métricas.
Grupos de agregaciónActualiza las etiquetas para administrar la cardinalidad de los métricas generadas.

Nota: Para cambiar el tipo o el nombre de la métrica, crea una nueva métrica y elimina la anterior.

Disponibilidad de datos

Las métricas generadas a partir de las trazas se emiten cuando finaliza una traza. En el caso de las trazas de larga duración, el retraso aumenta en consecuencia (por ejemplo, una métrica de traza de 45 minutos no puede emitirse hasta la finalización de la traza).

Cuando utilices métricas personalizadas a partir de trazas en monitores, ten en cuenta esta latencia para evitar falsos positivos.

Referencias adicionales