Descripción General
Ya sea que estés utilizando métricas, registros, trazas, monitores, tableros, cuadernos, etc., todos los gráficos en Datadog tienen la misma funcionalidad básica. Esta página describe cómo consultar con el editor gráfico. Los usuarios avanzados pueden crear y editar gráficos con JSON. Para aprender más, consulta Graficando con JSON.
Puedes consultar utilizando el editor de gráficos en las páginas de Tableros o Cuadernos, o puedes usar Quick Graphs disponible en cualquier página. Abre Gráficos Rápidos presionando G en cualquier página. Para aprender más, consulta la Guía de Gráficos Rápidos.
Editor de gráficos
En los widgets, abre el editor de gráficos haciendo clic en el ícono de lápiz en la esquina superior derecha. El editor de gráficos tiene las siguientes pestañas:
- Share: Inserta el gráfico en cualquier página web externa.
- JSON: Un editor más flexible, que requiere conocimiento del lenguaje de definición de gráficos.
- Edit: La pestaña de interfaz de usuario predeterminada para opciones de graficado.
Cuando abres por primera vez el editor de gráficos, estás en la pestaña Edit. Aquí, puedes usar la interfaz de usuario para elegir la mayoría de las configuraciones. Aquí hay un ejemplo:
Configurando un gráfico
Para configurar su gráfico en los tableros, siga este proceso:
- Seleccione la visualización
- Defina la métrica
- Filtre su métrica
- Configure la agregación temporal
- Configure la agregación espacial
- Aplique la función
- Titule el gráfico
Seleccione su visualización
Seleccione su visualización de los widgets disponibles.
Defina la métrica
Elija la métrica a graficar buscando o seleccionándola del menú desplegable junto a Metric. Si no sabe qué métrica usar, el menú desplegable de métricas proporciona información adicional, incluyendo el unit, type, interval, description, tags y el número de tag values.
También puede ver indicadores de origen de Datadog u OpenTelemetry. Si su entorno utiliza ambos, puede usar el modificador de consulta de fuente de Telemetría de Datadog para Consultar métricas de Datadog y OpenTelemetry en un solo gráfico.
Explore sus métricas más a fondo con el Metrics Explorer, un notebook o vea una lista de métricas en la página de Metrics Summary.
Filtrar
La métrica elegida puede ser filtrada por host o etiqueta usando el menú desplegable from a la derecha de la métrica. El filtro predeterminado es (en todas partes).
- Usa filtrado avanzado dentro del menú desplegable
from para evaluar consultas filtradas booleanas o filtradas por comodín. - Filtra consultas dinámicamente, utilizando Variables de Plantilla. Agrega el
$ con la clave de etiqueta y el gráfico aplica automáticamente la etiqueta que elijas en el menú desplegable de variables de plantilla. Para más información, consulta la documentación de Variables de Plantilla.
Para aprender más sobre etiquetas, consulta la documentación de Etiquetado.
Agregación y resumen
Método de agregación
El método de agregación está al lado del menú desplegable de filtros. Esto predetermina a avg by pero puedes cambiar el método a max by, min by o sum by. En la mayoría de los casos, la métrica tiene muchos valores para cada intervalo de tiempo, provenientes de muchos hosts o instancias. El método de agregación elegido determina cómo se agregan las métricas en una sola línea.
Independientemente de las opciones elegidas arriba, siempre hay alguna agregación de datos debido a las limitaciones de tamaño físico de la ventana que sostiene el gráfico. Si un métrico se actualiza cada segundo, y estás viendo 4 horas de datos, necesitas 14,400 puntos para mostrar todo. Cada gráfico mostrado tiene alrededor de 300 puntos visibles en cualquier momento. Por lo tanto, cada punto mostrado en la pantalla representa 48 puntos de datos.
En la práctica, las métricas son recopiladas por el Agente cada 15-20 segundos. Por lo tanto, un día de datos equivale a 4,320 puntos de datos. Si se muestra un día de datos en un solo gráfico, Datadog agrupa automáticamente los datos. Para más detalles sobre la agregación de tiempo, consulte la Introducción a las Métricas. Consulte la documentación de Rollup para aprender más sobre los intervalos de agrupamiento y cómo Datadog agrupa automáticamente los puntos de datos.
Para agrupar manualmente los datos, use la función de agrupamiento. Haga clic en el ícono de sigma para agregar una función y seleccione rollup del menú desplegable. Luego elija cómo desea agregar los datos y el intervalo en segundos.
Esta consulta crea una sola línea que representa el total de espacio en disco disponible, en promedio, en todas las máquinas agrupadas en intervalos de un minuto:
Al cambiar a la vista JSON, la consulta se ve así:
"query": "avg:system.disk.free{*}.rollup(avg, 60)"
El JSON completo se ve así:
{
"viz": "timeseries",
"requests": [
{
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "avg:system.disk.free{*}.rollup(avg, 60)"
}
],
"response_format": "timeseries",
"type": "line",
"style": {
"palette": "dog_classic",
"type": "solid",
"width": "normal"
}
}
],
"yaxis": {
"scale": "linear",
"min": "auto",
"max": "auto",
"include_zero": true,
"label": ""
},
"markers": []
}
Para más información sobre el uso de la vista JSON, consulte Graficando con JSON.
Junto al menú desplegable del método de agregación, elija qué constituye una línea o agrupación en un gráfico. Por ejemplo, si elige host, hay una línea para cada host. Cada línea está compuesta por la métrica seleccionada en un host particular agregada utilizando el método elegido.
Además, puede hacer clic en las etiquetas en el menú desplegable de métricas utilizadas para definir la métrica para agrupar y agregar sus datos.
Consultas anidadas
La función de consultas anidadas de Datadog le permite agregar capas adicionales de agregación de tiempo y/o espacio sobre los resultados de consultas de métricas existentes. Esta capacidad avanzada de consulta también le permite calcular percentiles y desviaciones estándar en los resultados de consultas agregadas de métricas de tipo conteo/tasa/gauge y acceder a consultas de mayor resolución a lo largo de marcos de tiempo históricos.
Para más información, consulta la documentación de Consultas Anidadas.
Gráficos avanzados
Dependiendo de tus necesidades de análisis, puedes optar por aplicar otras funciones matemáticas a la consulta. Los ejemplos incluyen tasas y derivadas, suavizado y otros. Consulta la lista de funciones disponibles.
Datadog también admite la capacidad de graficar tus métricas, registros, trazas y otras fuentes de datos con varias operaciones aritméticas y funciones de comparación. Utiliza +, -, /, *, minimum() y maximum() para modificar los valores mostrados en tus gráficos. Esta sintaxis permite tanto valores enteros como aritmética utilizando múltiples métricas.
Para graficar métricas por separado, utiliza la coma (,). Por ejemplo, a, b, c.
Nota: Las consultas que utilizan comas solo son compatibles en visualizaciones, no funcionan en monitores. Utiliza operadores booleanos u operaciones aritméticas para combinar múltiples métricas en un monitor.
Aritmética de métricas utilizando un entero
Modifica el valor mostrado de una métrica en un gráfico realizando una operación aritmética. Por ejemplo, para visualizar el doble de una métrica específica, haz clic en el enlace Advanced… en el editor de gráficos. Luego ingresa tu operación aritmética en el cuadro Formula, en este caso: a * 2:
Aritmética entre dos métricas
Visualiza el porcentaje de una métrica dividiendo una métrica sobre otra, por ejemplo:
jvm.heap_memory / jvm.heap_memory_max
Utiliza la opción Advanced… en el editor de gráficos y selecciona Add Query. Cada consulta se asigna una letra en orden alfabético: la primera métrica está representada por a, la segunda métrica está representada por b, etc.
Luego, en el cuadro Formula, ingresa la aritmética (a / b para este ejemplo). Para mostrar solo el resultado de la fórmula, consulta Ocultar una consulta de la visualización.
Aquí hay otro ejemplo que muestra cómo puedes graficar la proporción entre error registros y info registros.
status:error / status:info
Nota: Las fórmulas no tienen letras asignadas. No se puede realizar aritmética entre fórmulas.
Ocultar una consulta de la visualización
Cuando un widget tiene múltiples consultas y una fórmula, puede ocultar consultas individuales para que solo aparezca el resultado de la fórmula en el gráfico. Haz clic en la etiqueta de letra de la consulta para alternar su visibilidad en el gráfico. Una etiqueta azul indica que la consulta se muestra; una etiqueta gris indica que está oculta. La consulta oculta aún se utiliza en el cálculo de la fórmula.
Mínimo o Máximo entre dos consultas
Utiliza minimum() y maximum() para comparar dos consultas punto por punto y devolver el valor más bajo o más alto en cada marca de tiempo.
Nota: Usar min() y max() para comparación aritmética está en desuso. Utilice minimum() y maximum() en su lugar. Esta deprecación se aplica únicamente a la sintaxis de comparación aritmética. Los métodos de agregación como min by, max by y la agregación de consultas anidadas con min y max permanecen sin cambios.
Aquí hay un ejemplo usando maximum() para encontrar el uso máximo de CPU entre dos Availability Zones.
maximum(system.cpu.user{availability-zone:eastus-1}, system.cpu.user{availability-zone:eastus-2})
Además, también puede calcular el mínimo entre dos consultas en diferentes productos. Aquí hay otro ejemplo usando minimum() para encontrar el mínimo entre registros con estados de error y estados de advertencia.
minimum(status:error, status:warn)
Cree un alias
Puede crear un alias personalizado para sus fuentes de datos para facilitar la interpretación de los resultados del gráfico por parte de sus usuarios.
Cree un título
Si no ingresa un título, se genera uno automáticamente en función de sus selecciones. Sin embargo, se recomienda que cree un título que describa el propósito del gráfico.
Guardar
Haga clic en Done para guardar su trabajo y salir del editor. Siempre puede volver al editor para cambiar el gráfico. Si realiza cambios que no desea guardar, haga clic en Cancel.
Opciones adicionales
Superposiciones de eventos
Visualiza las correlaciones de eventos utilizando la sección Event Overlays en el editor de gráficos para la visualización Series temporales. En el campo de búsqueda, ingresa cualquier texto o consulta de búsqueda estructurada. La búsqueda de eventos utiliza la sintaxis de búsqueda de registros.
La superposición de eventos admite todas las fuentes de datos. Esto permite una correlación más fácil entre los eventos comerciales y los datos de cualquier servicio de Datadog.
Con la superposición de eventos, puede ver rápidamente cómo las acciones dentro de la organización impactan el rendimiento de la aplicación y la infraestructura. Aquí hay algunos casos de uso de ejemplo:
- Tasas de error de RUM con eventos de implementación superpuestos
- Correlacionando el uso de CPU con eventos relacionados con la provisión de servidores adicionales
- Correlacionando el tráfico de salida con actividad de inicio de sesión sospechosa
- Correlacionando cualquier dato de series temporales con alertas de Monitors para asegurar que Datadog ha sido configurado con las alertas apropiadas
Gráfico dividido
Con gráficos divididos, puede ver sus visualizaciones de métricas desglosadas por etiquetas.
- Acceda a esta función a través de la pestaña Split Graph al ver gráficos.
- Puede cambiar la métrica sort by para ver la relación entre los datos que está graficando y otras métricas.
- Limite el número de gráficos que se muestran cambiando el valor de limit to.
Lectura adicional
Documentación, enlaces y artículos útiles adicionales:
