Resumen

Las distribuciones son un tipo de métrica que agrega valores enviados desde múltiples servidores durante un intervalo de vaciado para medir distribuciones estadísticas en toda tu infraestructura.

Las distribuciones globales instrumentan objetos lógicos, como servicios, independientemente de los servidores subyacentes. A diferencia de los histogramas que se agregan del lado del agente, las distribuciones globales envían todos los datos crudos recopilados durante el intervalo de vaciado y la agregación ocurre del lado del servidor utilizando la estructura de datos DDSketch de Datadog.

Si utilizas OpenTelemetry, las métricas de histograma OTLP se mapean a distribuciones de Datadog por defecto. Consulta Tipos de métricas OTLP para obtener detalles sobre este mapeo y las opciones de configuración disponibles.

Las distribuciones proporcionan funcionalidades de consulta mejoradas y opciones de configuración que no se ofrecen con otros tipos de métricas (conteo, tasa, medidor, histograma):

• Cálculo de agregaciones percentiles: Las distribuciones se almacenan como estructuras de datos DDSketch que representan datos crudos, no agregados, de tal manera que se pueden calcular agregaciones percentiles globalmente precisas (p50, p75, p90, p95, p99 o cualquier percentil de tu elección con hasta dos puntos decimales) a partir de los datos crudos de todos tus servidores. Habilitar agregaciones percentiles puede desbloquear funcionalidades avanzadas de consulta como:

  • Valor percentil único sobre cualquier periodo de tiempo:

    "¿Cuál ha sido el tiempo de carga del percentil 99.9 para mi aplicación en la última semana?"

  • Desviación estándar sobre cualquier periodo de tiempo:

    "¿Cuál es la desviación estándar (stddev) del consumo de CPU de mi aplicación en el último mes?"

  • Umbrales percentiles en seguimientos de métricas:

    “Alérteme cuando el p95 de la latencia de solicitudes de mi aplicación sea mayor a 200 ms en los últimos 5 minutos.”

  • Consultas de umbral:

    “Me gustaría definir un SLO de 30 días donde el 95% de las solicitudes a mi servicio se completen en menos de 5 segundos.”

• Personalización de etiquetado: Esta funcionalidad te permite controlar el esquema de etiquetado para métricas personalizadas para las cuales no es necesaria una granularidad a nivel de host (por ejemplo, transacciones por segundo para un servicio de pago).

Nota: Debido a que los datos métricos de distribuciones se almacenan de manera diferente a otros tipos, cualquier nombre de métrica utilizado para un distribution no debe ser utilizado para ningún otro tipo de métricas.

Habilitando funcionalidad avanzada de consultas

Al igual que otros tipos de métricas, como gauges o histograms, las distribuciones tienen las siguientes agregaciones disponibles: count, min, max, sum y avg. Las distribuciones se etiquetan inicialmente de la misma manera que otras métricas, con etiquetas personalizadas establecidas en el código. Luego se resuelven a etiquetas de host basadas en el host que reportó la métrica.

Sin embargo, puede habilitar la funcionalidad avanzada de consultas, como el cálculo de agregaciones percentiles globalmente precisas para todas las etiquetas consultables en su distribución en la página de Resumen de Métricas. Esto proporciona agregaciones para p50, p75, p90, p95 y p99 o cualquier percentil definido por el usuario de tu elección (con hasta dos puntos decimales, como 99.99). Habilitar consultas avanzadas también desbloquea consultas de umbral y desviación estándar.

Después de optar por aplicar agregaciones percentiles en una métrica de distribución, estas agregaciones están automáticamente disponibles en la interfaz de usuario de gráficos:

Puede usar agregaciones percentiles en una variedad de otros widgets y para alertas:

• Valor de percentil único sobre cualquier período de tiempo

  "¿Cuál ha sido la duración de solicitud del percentil 99.9 para mi aplicación en la última semana?"

• Umbrales de percentil en monitores de métricas “Alérteme cuando el p95 de la latencia de solicitud de mi aplicación sea mayor a 200 ms durante los últimos 5 minutos.”

Configuración masiva para múltiples métricas

Puede habilitar o deshabilitar las agregaciones percentiles para múltiples métricas a la vez, en lugar de tener que configurar cada una individualmente.

1. Navegue a la Página de Resumen de Métricas y haga clic en el menú desplegable Configurar Métricas.
2. Seleccione Habilitar percentiles.
3. Especifique un prefijo de espacio de nombres de métrica para seleccionar todas las métricas que coincidan con ese espacio de nombres.
4. (Opcional) Para deshabilitar los percentiles para todas las métricas en el espacio de nombres, haga clic en el interruptor Agregaciones percentiles.

Consultas de Umbral

Habilitar percentiles calculados por DDSketch, que son globalmente precisos en sus métricas de distribución, desbloquea consultas de umbral donde puede contar el número de valores de métricas de distribución en bruto si superan o caen por debajo de un umbral numérico. Puede utilizar esta funcionalidad para contar el número de errores o violaciones en comparación con un umbral numérico anómalo en los paneles. O también puede utilizar consultas de umbral para definir SLOs como “el 95% de las solicitudes se completaron en menos de 10 segundos en los últimos 30 días”.

Con consultas de umbral para distribuciones con percentiles, no necesita predefinir un valor de umbral antes de la presentación de métricas, y tiene total flexibilidad para ajustar el valor del umbral en Datadog.

Para utilizar consultas de umbral:

1. Habilite percentiles en su métrica de distribución en la página de Metrics Summary.
2. Grafique su métrica de distribución elegida utilizando el agregador “contar valores…”.
3. Especifique un valor de umbral y un operador de comparación.

Puede crear de manera similar un SLO basado en métricas utilizando consultas de umbral:

1. Habilite percentiles en su métrica de distribución en la página de Resumen de Métricas.
2. Crea un nuevo SLO basado en métricas y define el numerador como el número de eventos “buenos” con una consulta sobre tu métrica de distribución elegida utilizando el agregador “contar valores…”.
3. Especifica un valor umbral y un operador de comparación.

Personaliza la etiquetación

Las distribuciones proporcionan funcionalidad que te permite controlar la etiquetación para métricas personalizadas donde la granularidad a nivel de host no tiene sentido. Las configuraciones de etiquetas son listas permitidas de las etiquetas que te gustaría mantener.

Para personalizar la etiquetación:

1. Haz clic en el nombre de tu métrica de distribución personalizada en la tabla de Metrics Summary para abrir el panel lateral de detalles de métricas.
2. Haz clic en el botón Administrar Etiquetas para abrir el modal de configuración de etiquetas.
3. Haz clic en Personalizado… pestaña para personalizar las etiquetas que te gustaría mantener disponibles para consulta.

Nota: La exclusión de etiquetas no es compatible en la personalización de etiquetas basada en listas permitidas. No se aceptan etiquetas que comiencen con !.

Eventos de auditoría

Cualquier cambio en la configuración de etiquetas o en la agregación de percentiles crea un evento en el explorador de eventos. Este evento explica el cambio y muestra al usuario que realizó el cambio.

Si creaste, actualizaste o eliminaste una configuración de etiquetas en una métrica de distribución, puedes ver ejemplos con la siguiente búsqueda de eventos:

https://app.datadoghq.com/event/stream?tags_execution=and&per_page=30&query=tags%3Aaudit%20status%3Aall%20priority%3Aall%20tag%20configuration

Si agregaste o eliminaste agregaciones de percentiles a una métrica de distribución, puedes ver ejemplos con la siguiente búsqueda de eventos:

https://app.datadoghq.com/event/stream?tags_execution=and&per_page=30&query=tags%3Aaudit%20status%3Aall%20priority%3Aall%20percentile%20aggregations

Lectura adicional

Más enlaces, artículos y documentación útiles:

Uso de distribuciones en DogStatsDDOCUMENTACIÓN Tipos de métricas OTLPDOCUMENTACIÓN