Descripción General
Ya sea que estés utilizando métricas, registros, trazas, seguimientos, Dashboards, Notebooks, 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 gráfico en las páginas de Dashboards o Notebooks, o puedes usar Quick Graphs disponible en cualquier página. Abre Quick Graphs presionando G en cualquier página. Para aprender más, consulta la Quick Graphs Guide.
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: Incrusta 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 Dashboards, siga este proceso:
- Seleccione la visualización
- Defina la métrica
- Filtre su métrica
- Configure la agregación de tiempo
- Configure el desglose 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 para 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 selector de Semantic Mode 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 servidor 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.
Agregue y agrupe
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 servidores 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 una métrica 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 mostrados 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 espacio total disponible en disco, en promedio, a través de 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 sobre 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. Usa: +, -, /, *, min, y max 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, usa la coma (,). Por ejemplo, a, b, c.
Nota: Las consultas que utilizan comas solo son compatibles en visualizaciones, no funcionan en seguimientos. Usa operadores booleanos u operaciones aritméticas para combinar múltiples métricas en un seguimiento.
Aritmética de métricas usando 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 la caja Formula, ingresa la aritmética (a / b para este ejemplo). Para mostrar solo la fórmula en tu gráfico, haz clic en las marcas de verificación junto a las métricas a y b.
Aquí hay otro ejemplo que muestra cómo puedes graficar la razón entre error registros y info registros.
status:error / status:info
Nota: Las fórmulas no están designadas con letras. No se puede realizar aritmética entre fórmulas.
Mínimo o Máximo entre dos consultas
Aquí hay un ejemplo utilizando el operador max para encontrar el uso máximo de CPU entre dos Availability Zones.
max(system.cpu.user{availability-zone:eastus-1}, system.cpu.user{availability-zone:eastus-2})
Además, también puedes calcular el máximo (o mínimo) entre dos consultas en diferentes productos. Aquí hay otro ejemplo utilizando el operador min para encontrar el mínimo entre registros con estados de error y estados de advertencia.
min(status:error, status:warn)
Crea un alias
Puedes crear un alias personalizado para tus fuentes de datos para facilitar la interpretación de los resultados del gráfico por parte de tus usuarios.
Crea un título
Si no ingresas un título, se genera uno automáticamente basado en tus selecciones. Sin embargo, se recomienda que crees un título que describa el propósito del gráfico.
Guardar
Haz clic en Done para guardar tu trabajo y salir del editor. Siempre puedes regresar al editor para cambiar el gráfico. Si realizas cambios que no deseas guardar, haz 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 de Series Temporales. En el campo de búsqueda, ingresa cualquier texto o consulta 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 eventos comerciales y datos de cualquier servicio de Datadog.
Con la superposición de eventos, puedes 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 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 seguimiento para asegurar que Datadog se haya configurado con las alertas apropiadas.
Gráfico dividido
Con los gráficos divididos, puedes ver tus visualizaciones métricas desglosadas por etiquetas.
- Accede a esta función a través de la pestaña Split Graph al ver gráficos.
- Puedes cambiar la sort by métrica para ver la relación entre los datos que estás graficando y otras métricas.
- Limita el número de gráficos que se muestran cambiando el limit to valor.
Lectura adicional
Más enlaces, artículos y documentación útiles:
