Manipulación de paneles¶

La manipulación de paneles comprende todas las operaciones necesarias para crear, configurar, organizar, duplicar, mover, redimensionar y eliminar paneles dentro de un dashboard de Grafana.

Un panel no es únicamente un gráfico. Está formado por varios elementos relacionados:

Consulta
   |
   v
Fuente de datos
   |
   v
Transformaciones
   |
   v
Visualización
   |
   v
Opciones del panel
   |
   v
Panel dentro del dashboard

Durante esta sección se aprenderá a modificar paneles de forma controlada y a construir dashboards claros, ordenados y fáciles de mantener.

Objetivos¶

Al finalizar esta sección, el alumno podrá:

Crear un panel nuevo.
Seleccionar una fuente de datos.
Introducir y probar consultas PromQL.
Cambiar el tipo de visualización.
Modificar el título de un panel.
Añadir una descripción.
Configurar unidades y decimales.
Configurar umbrales y colores.
Configurar leyendas.
Mover paneles dentro de un dashboard.
Redimensionar paneles.
Duplicar paneles.
Copiar paneles entre dashboards.
Eliminar paneles.
Deshacer cambios cuando sea posible.
Guardar correctamente un dashboard.
Utilizar el inspector de paneles.
Diagnosticar paneles sin datos.
Organizar paneles según su importancia.
Documentar los cambios realizados.
Exportar un dashboard como copia de seguridad.

Introducción¶

Un dashboard de Grafana se construye mediante paneles. Cada panel representa una consulta o un conjunto de consultas y muestra el resultado mediante una visualización.

Un panel puede mostrar:

Un único valor.
Una serie temporal.
Una tabla.
Una comparación entre servidores.
Un indicador de porcentaje.
Una distribución de valores.
Texto explicativo.
Un diseño visual personalizado.

La manipulación de paneles permite adaptar el dashboard a las necesidades de cada usuario.

Por ejemplo, una consulta de disponibilidad puede mostrarse como:

up

Esta consulta puede representarse mediante:

Una tabla para conocer cada objetivo.
Un panel Stat para mostrar el número total de objetivos.
Un Gauge para mostrar el porcentaje de disponibilidad.
Un Bar Gauge para comparar varias instancias.

La consulta puede ser la misma, pero la visualización y el objetivo del panel son diferentes.

Ciclo de vida de un panel¶

El ciclo habitual de un panel es:

Crear
  |
  v
Configurar fuente de datos
  |
  v
Introducir consulta
  |
  v
Seleccionar visualización
  |
  v
Configurar opciones
  |
  v
Probar datos
  |
  v
Organizar posición
  |
  v
Guardar dashboard
  |
  v
Documentar cambios

Crear¶

Se añade un panel nuevo a un dashboard existente.

Configurar¶

Se seleccionan:

Fuente de datos.
Consulta.
Visualización.
Unidades.
Umbrales.
Leyenda.
Título.
Descripción.

Probar¶

Se comprueba que:

La consulta es válida.
El panel muestra datos.
La unidad es correcta.
Los colores tienen sentido.
El rango temporal es adecuado.

Organizar¶

Se decide:

Dónde colocar el panel.
Qué tamaño debe tener.
Con qué paneles debe agruparse.
Qué información debe aparecer antes.

Guardar¶

Los cambios deben guardarse en el dashboard.

Partes principales de un panel¶

Título¶

El título identifica el propósito del panel.

Evitar:

Panel nuevo
Consulta 1
Gráfico

Utilizar:

Uso de CPU por instancia
Estado de los objetivos
Memoria disponible
Espacio utilizado en /

Descripción¶

La descripción proporciona contexto adicional.

Ejemplo:

Porcentaje de CPU utilizado durante los últimos cinco minutos.
El cálculo excluye el tiempo de CPU en modo idle.

Una descripción útil debe responder:

¿Qué representa el panel?
¿Qué unidad utiliza?
¿Qué rango temporal se emplea?
¿Qué significa un valor elevado?
¿Qué acción debe realizarse?

Fuente de datos¶

La fuente de datos indica de dónde obtiene Grafana la información.

En este módulo se utilizará principalmente:

Prometheus

URL habitual:

http://localhost:9090

Consulta¶

La consulta obtiene los valores que se mostrarán.

Ejemplo:

node_load1

Visualización¶

La visualización determina cómo se representan los datos.

Ejemplos:

Stat
Gauge
Bar Gauge
Time series
Table
Heatmap
Text
Canvas

Opciones¶

Las opciones controlan el aspecto y el comportamiento del panel.

Entre ellas:

Unidad.
Decimales.
Min.
Max.
Umbrales.
Colores.
Leyenda.
Ejes.
Orientación.
Apilamiento.
Puntos.
Líneas.
Transparencia.

Transformaciones¶

Las transformaciones modifican el resultado antes de mostrarlo.

Pueden utilizarse para:

Renombrar campos.
Ocultar columnas.
Filtrar resultados.
Ordenar datos.
Combinar consultas.
Crear campos calculados.

Crear un panel¶

Procedimiento general¶

Abrir Grafana.
Acceder a un dashboard.
Seleccionar la opción para añadir un panel.
Seleccionar la fuente de datos.
Introducir la consulta.
Elegir una visualización.
Configurar las opciones.
Revisar el resultado.
Guardar el panel.
Guardar el dashboard.

Consulta inicial recomendada¶

Para comprobar que la fuente de datos funciona, utilizar:

up

Esta consulta permite verificar rápidamente si Prometheus está recibiendo métricas.

Crear un panel de disponibilidad¶

Configurar:

Título: Estado de los objetivos
Fuente de datos: Prometheus
Consulta: up
Visualización: Table

Resultado esperado:

job            instance          Value
prometheus     localhost:9090    1
node_exporter  localhost:9100    1

Interpretación:

1 = objetivo disponible
0 = objetivo no disponible

Editar un panel¶

Acceder al editor¶

Para editar un panel:

Abrir el dashboard.
Localizar el panel.
Abrir el menú del panel.
Seleccionar la opción de edición.

Desde el editor se pueden modificar:

Consulta.
Fuente de datos.
Visualización.
Título.
Descripción.
Unidades.
Umbrales.
Leyendas.
Transformaciones.
Ejes.
Colores.
Rangos.

Proceso recomendado¶

Al editar un panel:

1. Revisar la consulta.
2. Confirmar la fuente de datos.
3. Revisar el tipo de visualización.
4. Configurar la unidad.
5. Revisar los umbrales.
6. Probar el resultado.
7. Guardar el panel.
8. Guardar el dashboard.

No conviene cambiar muchas opciones sin comprobar el resultado. Es mejor realizar modificaciones pequeñas y verificables.

Modificar el título¶

Un título debe describir el dato y, cuando sea necesario, el contexto.

Ejemplos incorrectos¶

CPU
Memoria
Panel de datos
Gráfico principal

Ejemplos recomendados¶

Uso de CPU por instancia
Porcentaje de memoria utilizada
Espacio utilizado en el sistema de ficheros raíz
Tráfico recibido por instancia
Estado de los objetivos de Prometheus

Convención recomendada¶

<Métrica> [por <dimensión>]

Ejemplos:

Uso de CPU por instancia
Tráfico recibido por interfaz
Uso de almacenamiento por punto de montaje
Estado de objetivos por job

Añadir una descripción¶

Una descripción puede documentar el significado del panel.

Ejemplo:

Muestra el porcentaje de CPU utilizado durante los últimos cinco minutos.

El cálculo se obtiene a partir de node_cpu_seconds_total y excluye
el tiempo de CPU en modo idle.

Otro ejemplo:

Muestra el porcentaje de memoria utilizada.

Valores superiores al 90 % deben investigarse porque pueden provocar
problemas de rendimiento o falta de memoria disponible.

Recomendaciones¶

Utilizar frases breves.
Explicar la unidad.
Indicar el significado de los valores altos.
Documentar filtros importantes.
Indicar si se utiliza una agregación.
Evitar repetir exactamente el título.

Cambiar la fuente de datos¶

Un panel puede utilizar una fuente de datos concreta.

Ejemplo:

Fuente actual: Prometheus
Nueva fuente: Prometheus-Laboratorio

Al cambiar la fuente de datos, comprobar:

Que la fuente existe.
Que está disponible.
Que contiene las métricas necesarias.
Que las consultas siguen siendo compatibles.
Que las variables funcionan.
Que no se han perdido los datos.

Problemas habituales¶

Si el panel queda vacío después de cambiar la fuente:

Comprobar la fuente seleccionada.
Ejecutar una consulta sencilla:

up

Comprobar el rango temporal.
Comprobar los objetivos.
Revisar las etiquetas.
Confirmar que la nueva fuente contiene las métricas necesarias.

Cambiar la visualización¶

La misma consulta puede representarse de distintas formas.

Utilizar:

up

Probar:

Table
Stat
Gauge
Bar Gauge
Time series

Tabla¶

Adecuada para consultar etiquetas y valores.

job            instance          Value
prometheus     localhost:9090    1
node_exporter  localhost:9100    1

Stat¶

Adecuada para mostrar un valor resumido.

Consulta recomendada:

sum(up)

Gauge¶

Adecuada para mostrar un valor frente a un rango.

Consulta recomendada:

100 * avg(up)

Bar Gauge¶

Adecuada para comparar varias series.

Consulta:

up

Time series¶

Adecuada para representar una evolución temporal.

Consulta:

node_load1

Criterio de selección¶

Tipo de dato	Visualización recomendada
Un valor actual	Stat
Porcentaje frente a límites	Gauge
Comparación entre elementos	Bar Gauge
Evolución temporal	Time series
Etiquetas y valores	Table
Documentación	Text
Distribución	Heatmap

Configurar unidades¶

Las unidades hacen que un valor sea interpretable.

CPU¶

Consulta:

100 - (
  avg by (instance) (
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

Unidad:

Percent (0-100)

Memoria en bytes¶

Consulta:

node_memory_MemAvailable_bytes

Unidad:

Bytes

o:

Bytes (IEC)

Memoria en porcentaje¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Unidad:

Percent (0-100)

Tráfico de red¶

Consulta:

rate(node_network_receive_bytes_total[5m])

Unidad:

bytes/sec

Carga del sistema¶

Consulta:

node_load1

Unidad:

None

La carga no debe confundirse con un porcentaje de CPU.

Configurar decimales¶

Los decimales deben ajustarse al nivel de precisión necesario.

Ejemplos:

Tipo de dato	Decimales recomendados
Porcentaje de CPU	1 o 2
Porcentaje de memoria	1 o 2
Número de objetivos	0
Bytes	Automático
Carga del sistema	2
Tráfico de red	1 o 2

No conviene mostrar muchos decimales si no aportan información.

Evitar:

73.4839201847 %

Utilizar:

73.5 %

Configurar límites mínimos y máximos¶

Los límites ayudan a que un panel represente correctamente el rango esperado.

Para un porcentaje:

Min: 0
Max: 100

Para una disponibilidad:

Min: 0
Max: 100

Para un Gauge de CPU:

Min: 0
Max: 100

La configuración de límites debe corresponder al significado de la métrica.

No se debe establecer automáticamente un máximo de 100 para una métrica de carga del sistema, porque la carga no representa necesariamente un porcentaje.

Configurar umbrales¶

Ejemplo de memoria¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Umbrales:

0     Verde
70    Amarillo
90    Rojo

Interpretación:

0 - 69.99 %   Estado normal
70 - 89.99 %  Advertencia
90 - 100 %    Estado crítico

Ejemplo de almacenamiento¶

Consulta:

100 * (
  1 -
  node_filesystem_avail_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
  /
  node_filesystem_size_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
)

Umbrales:

0     Verde
80    Amarillo
90    Rojo

Buenas prácticas¶

Documentar los umbrales.
Utilizar la misma convención en todo el dashboard.
No utilizar rojo para valores normales.
Revisar si los umbrales dependen del entorno.
No confundir un umbral visual con una alerta.

Configurar leyendas¶

La leyenda ayuda a identificar cada serie.

Para una consulta por instancia:

100 - (
  avg by (instance) (
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

La leyenda puede mostrar:

{{instance}}

Para una consulta por interfaz:

rate(node_network_receive_bytes_total[5m])

La leyenda puede mostrar:

{{device}}

Una leyenda útil debe mostrar las etiquetas necesarias, pero no todas las etiquetas disponibles.

Evitar leyendas excesivamente largas.

Mover paneles¶

Los paneles pueden moverse para organizar la distribución del dashboard.

Criterio de organización¶

Colocar primero:

Estado general.
Disponibilidad.
Recursos críticos.
Tendencias.
Detalle.
Información adicional.

Ejemplo:

+------------------------------------------------------+
| Descripción                                          |
+------------------------------------------------------+
| Estado de objetivos                                  |
+----------------------+-------------------------------+
| Uso de CPU           | Uso de memoria                |
+----------------------+-------------------------------+
| Almacenamiento       | Carga del sistema             |
+----------------------+-------------------------------+
| Tráfico recibido     | Tráfico enviado               |
+----------------------+-------------------------------+

Recomendaciones¶

Agrupar paneles relacionados.
Mantener una lectura de arriba abajo.
Evitar saltos visuales.
Colocar los paneles críticos en la parte superior.
Separar información operativa y descriptiva.
Revisar el dashboard en una pantalla de tamaño normal.

Redimensionar paneles¶

El tamaño del panel debe corresponder a la cantidad de información que muestra.

Paneles pequeños¶

Adecuados para:

Stat.
Gauge.
Indicadores sencillos.
Valores resumidos.

Paneles medianos¶

Adecuados para:

Time series.
Tablas pequeñas.
Bar Gauge.
Gráficos con pocas series.

Paneles grandes¶

Adecuados para:

Series temporales complejas.
Tablas extensas.
Heatmaps.
Paneles Canvas.
Visualizaciones con varias leyendas.

Problemas de tamaño¶

Un panel demasiado pequeño puede provocar:

Títulos cortados.
Leyendas ilegibles.
Ejes ocultos.
Valores truncados.
Dificultad para interpretar los datos.

Un panel demasiado grande puede desperdiciar espacio.

Duplicar un panel¶

Duplicar un panel permite crear otro panel con una configuración similar.

Es útil cuando:

Se quiere reutilizar una consulta.
Solo cambia una métrica.
Solo cambia una etiqueta.
Se desea comparar CPU y memoria.
Se quiere crear una versión para otra instancia.

Procedimiento conceptual¶

Abrir el menú del panel.
Seleccionar la opción de duplicar.
Cambiar el título.
Modificar la consulta.
Revisar la visualización.
Guardar.

Ejemplo¶

Panel original:

Uso de CPU

Consulta:

100 - (
  avg by (instance) (
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

Panel duplicado:

Uso de memoria

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Aunque ambos paneles pueden utilizar un Gauge, sus unidades, títulos y consultas son diferentes.

Copiar un panel entre dashboards¶

Copiar un panel permite reutilizarlo en otro dashboard.

Antes de copiarlo, comprobar:

Que la fuente de datos existe en el dashboard destino.
Que las variables tienen nombres compatibles.
Que las métricas están disponibles.
Que los plugins necesarios están instalados.
Que los umbrales son adecuados para el nuevo contexto.

Un panel copiado puede necesitar ajustes.

No se debe asumir que funcionará sin modificaciones.

Eliminar un panel¶

Eliminar un panel no elimina la métrica de Prometheus ni borra otros paneles.

Solo elimina la representación del panel dentro del dashboard.

Antes de eliminarlo:

Confirmar que es el panel correcto.
Revisar si contiene una consulta importante.
Exportar el dashboard si se trata de un dashboard relevante.
Comprobar si el panel puede archivarse o duplicarse.
Confirmar la eliminación.

Diferencia importante¶

Eliminar un panel:
Elimina una visualización del dashboard.

Eliminar un dashboard:
Elimina toda la estructura del dashboard.

Eliminar una métrica:
No se realiza desde Grafana.

Guardar los cambios¶

Después de modificar un panel, normalmente hay dos niveles de guardado:

Guardar cambios del panel
        |
        v
Guardar cambios del dashboard

Comprobar siempre que:

El título se conserva.
La consulta se conserva.
La visualización se conserva.
La posición se conserva.
La fuente de datos es correcta.
El dashboard aparece sin cambios pendientes.

Deshacer cambios¶

Cuando se realizan cambios experimentales:

Cambiar una sola opción.
Observar el resultado.
Guardar únicamente si el resultado es correcto.
Deshacer o cancelar si no es correcto.
Utilizar una copia de seguridad antes de cambios importantes.

No todas las modificaciones pueden deshacerse automáticamente después de cerrar o guardar el dashboard.

Por eso conviene exportar una copia de los dashboards importantes.

Inspector de paneles¶

El inspector ayuda a comprender qué está ocurriendo dentro de un panel.

Puede mostrar:

Datos devueltos.
Consulta ejecutada.
Tiempo de respuesta.
Errores.
Series resultantes.
Datos transformados.
JSON del panel.

Utilidades¶

El inspector es útil cuando:

El panel no muestra datos.
La consulta devuelve resultados inesperados.
Hay demasiadas series.
La transformación no produce el resultado esperado.
La unidad parece incorrecta.
La consulta tarda demasiado.

Procedimiento de diagnóstico¶

1. Abrir el panel.
2. Abrir el inspector.
3. Revisar la consulta.
4. Revisar los datos devueltos.
5. Revisar los errores.
6. Comparar con Prometheus.
7. Corregir la consulta.
8. Guardar el panel.

Ejemplo de panel de disponibilidad¶

Consulta original¶

up

Resultado esperado¶

up{job="prometheus",instance="localhost:9090"} 1
up{job="node_exporter",instance="localhost:9100"} 1

Configuración como tabla¶

Título: Estado de los objetivos
Visualización: Table
Unidad: None

Configuración como Stat¶

Consulta:

sum(up)

Título: Objetivos disponibles
Visualización: Stat
Unidad: None

Configuración como porcentaje¶

Consulta:

100 * avg(up)

Título: Disponibilidad global
Visualización: Gauge
Unidad: Percent (0-100)
Min: 0
Max: 100

Ejemplo de panel de CPU¶

Consulta¶

100 - (
  avg by (instance) (
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

Configuración¶

Título: Uso de CPU por instancia
Visualización: Time series
Unidad: Percent (0-100)
Decimales: 1
Rango temporal: Last 1 hour

Descripción¶

Porcentaje de CPU utilizado por instancia durante los últimos cinco minutos.

Actividad adicional¶

Generar carga temporal:

yes > /dev/null &

Observar el panel y detener la carga:

pkill yes

Ejemplo de panel de memoria¶

Consulta¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Configuración¶

Título: Uso de memoria
Visualización: Gauge
Unidad: Percent (0-100)
Min: 0
Max: 100

Umbrales¶

0     Verde
70    Amarillo
90    Rojo

Descripción¶

Porcentaje de memoria utilizada. Los valores superiores al 90 %
requieren una revisión del consumo de procesos y de la memoria disponible.

Ejemplo de panel de almacenamiento¶

Consulta¶

100 * (
  1 -
  node_filesystem_avail_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
  /
  node_filesystem_size_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
)

Configuración¶

Título: Uso del sistema de ficheros raíz
Visualización: Gauge
Unidad: Percent (0-100)
Min: 0
Max: 100

Umbrales¶

0     Verde
80    Amarillo
90    Rojo

Comparación con el sistema operativo¶

df -h /

El resultado de PromQL y df -h puede variar ligeramente debido al momento de consulta y a las diferencias de cálculo.

Ejemplo de panel de red¶

Tráfico recibido¶

sum by (instance) (
  rate(node_network_receive_bytes_total{
    device!="lo"
  }[5m])
)

Tráfico enviado¶

sum by (instance) (
  rate(node_network_transmit_bytes_total{
    device!="lo"
  }[5m])
)

Configuración¶

Visualización: Time series
Unidad: bytes/sec
Título: Tráfico de red

Descripción¶

Tráfico de red agregado por instancia. La interfaz de loopback se excluye
para evitar incluir tráfico interno del sistema.

Ejemplo de sesión 1: crear un panel desde cero¶

Objetivo¶

Crear un panel de tipo Stat que muestre el número de objetivos disponibles.

Pasos¶

Abrir Grafana.
Acceder al dashboard:

Monitorización de servidor Linux

Añadir un panel nuevo.
Seleccionar la fuente Prometheus.
Introducir:

sum(up)

Seleccionar la visualización Stat.
Configurar el título:

Objetivos disponibles

Configurar la unidad como None.
Guardar el panel.
Guardar el dashboard.

Actividades¶

Comprueba el valor mostrado.
Compáralo con la consulta up.
Cambia temporalmente la consulta a:

count(up)

Explica la diferencia entre sum(up) y count(up).
Restaura la consulta original.

Ejemplo de sesión 2: editar la visualización¶

Objetivo¶

Cambiar un panel de tabla a Gauge y adaptar su consulta.

Situación inicial¶

Panel:

Estado de los objetivos

Consulta:

up

Visualización:

Table

Pasos¶

Editar el panel.
Cambiar la consulta a:

100 * avg(up)

Cambiar la visualización a Gauge.
Configurar:

Unidad: Percent (0-100)
Min: 0
Max: 100

Establecer el título:

Disponibilidad global

Configurar umbrales:

0     Rojo
90    Amarillo
99    Verde

Guardar el panel.

Actividades¶

Comprueba el resultado.
Detén Node Exporter.
Observa el cambio.
Inicia Node Exporter.
Comprueba la recuperación.
Explica si la visualización Gauge ofrece más o menos detalle que la tabla.

Ejemplo de sesión 3: duplicar y modificar un panel¶

Objetivo¶

Crear un panel de memoria a partir de un panel existente.

Pasos¶

Localizar el panel de CPU.
Duplicarlo.
Cambiar el título a:

Uso de memoria

Sustituir la consulta por:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Seleccionar Gauge.
Configurar la unidad:

Percent (0-100)

Configurar:

Min: 0
Max: 100

Añadir umbrales.
Guardar el panel.
Guardar el dashboard.

Actividades¶

Comprueba que el panel original de CPU no ha cambiado.
Comprueba que el panel duplicado muestra memoria.
Revisa título, unidad y umbrales.
Añade una descripción.
Explica qué elementos se reutilizaron y cuáles se modificaron.

Ejemplo de sesión 4: mover y redimensionar paneles¶

Objetivo¶

Organizar visualmente un dashboard.

Distribución inicial¶

Supongamos que todos los paneles están desordenados.

Organización deseada¶

+------------------------------------------------------+
| Descripción                                          |
+------------------------------------------------------+
| Objetivos disponibles                                |
+----------------------+-------------------------------+
| Uso de CPU           | Uso de memoria                |
+----------------------+-------------------------------+
| Almacenamiento       | Carga del sistema             |
+----------------------+-------------------------------+
| Tráfico recibido     | Tráfico enviado               |
+----------------------+-------------------------------+

Pasos¶

Colocar el panel de descripción en la parte superior.
Colocar el estado de los objetivos debajo.
Colocar CPU y memoria en la misma fila.
Colocar almacenamiento y carga en la siguiente fila.
Colocar tráfico de red al final.
Ampliar los paneles temporales.
Reducir los paneles Stat y Gauge.
Revisar que los títulos sean legibles.
Guardar el dashboard.

Actividades¶

Reorganiza el dashboard.
Redimensiona cada panel.
Comprueba la lectura en una ventana normal.
Comprueba la lectura en pantalla completa.
Explica por qué los indicadores resumen pueden ocupar menos espacio.

Ejemplo de sesión 5: diagnosticar un panel sin datos¶

Objetivo¶

Identificar el origen de un panel vacío.

Consulta de prueba¶

Introducir deliberadamente:

metrica_que_no_existe

Observaciones¶

La fuente de datos puede estar funcionando correctamente aunque esta consulta no devuelva resultados.

Procedimiento¶

Revisar la fuente de datos.
Probar:

up

Probar:

node_memory_MemAvailable_bytes

Revisar el rango temporal.
Abrir el inspector.
Revisar los mensajes de error.
Restaurar una consulta válida.

Actividades¶

Describe la diferencia entre:
Fuente desconectada.
Consulta inválida.
Consulta válida sin resultados.
Métrica inexistente.
Documenta el diagnóstico.
Guarda una captura del inspector.
Restaura el panel.

Ejemplo de sesión 6: copiar un panel a otro dashboard¶

Objetivo¶

Reutilizar un panel en otro dashboard.

Pasos¶

Abrir el dashboard de recursos.
Seleccionar el panel de uso de memoria.
Copiar el panel.
Abrir el dashboard de laboratorio.
Pegar el panel.
Revisar la fuente de datos.
Revisar la consulta.
Revisar la unidad.
Guardar el dashboard destino.

Actividades¶

Comprueba que el panel funciona en ambos dashboards.
Modifica el título solo en el dashboard destino.
Comprueba que el original mantiene su título.
Explica por qué conviene revisar las variables después de copiar un panel.

Ejemplo de sesión 7: eliminar y recuperar un panel¶

Objetivo¶

Practicar la eliminación controlada de un panel.

Pasos¶

Exportar el dashboard como JSON.
Crear un panel de prueba con:

up

Nombrarlo:

Panel temporal

Guardar el dashboard.
Eliminar el panel.
Guardar el dashboard.
Importar la copia exportada en otro dashboard.
Comprobar que el panel temporal sigue existiendo en la copia.

Actividades¶

Explica por qué se realizó una exportación.
Compara el dashboard original y la copia.
Comprueba que eliminar el panel no afecta a Prometheus.
Documenta el procedimiento de recuperación.

Ejemplo de sesión 8: utilizar el inspector¶

Objetivo¶

Revisar los datos internos de un panel.

Pasos¶

Abrir un panel de CPU.
Abrir el inspector.
Revisar la consulta.
Revisar los datos devueltos.
Revisar las etiquetas.
Revisar el tiempo de respuesta.
Revisar el resultado transformado, si existe.
Cerrar el inspector sin modificar el panel.

Actividades¶

Anota el número de series devueltas.
Identifica las etiquetas principales.
Comprueba la unidad original.
Compara el resultado con Prometheus.
Explica cómo utilizarías el inspector ante un panel vacío.

Buenas prácticas de manipulación¶

Realizar cambios pequeños¶

Modificar una opción cada vez facilita identificar problemas.

Probar antes de guardar¶

No guardar cambios incorrectos en dashboards importantes.

Exportar antes de cambios importantes¶

Especialmente antes de:

Modificar muchas consultas.
Cambiar transformaciones.
Cambiar variables.
Reorganizar dashboards críticos.
Actualizar plugins.

Utilizar títulos consistentes¶

Mantener una convención común en todos los paneles.

Configurar unidades siempre¶

Un número sin unidad puede inducir a error.

Documentar transformaciones¶

Indicar qué datos se ocultan, calculan o agrupan.

Revisar el comportamiento con diferentes rangos temporales¶

Un panel puede ser correcto para una hora, pero difícil de interpretar para siete días.

Comprobar el rendimiento¶

Consultas muy complejas o demasiados paneles pueden aumentar la carga de Grafana y Prometheus.

Mantener la legibilidad¶

El panel debe poder interpretarse rápidamente.

Problemas habituales¶

El panel no muestra datos¶

Comprobar:

up

Después:

node_memory_MemAvailable_bytes

Revisar:

Fuente de datos.
Consulta.
Rango temporal.
Estado de los objetivos.
Etiquetas.
Variables.
Transformaciones.

El título no se actualiza¶

Comprobar:

Que el panel se ha guardado.
Que el dashboard se ha guardado.
Que no se ha editado otro panel.
Que no existe un conflicto de versión.

La consulta devuelve demasiadas series¶

Utilizar:

Filtros.
Agregaciones.
Variables.
Transformaciones.

Ejemplo:

sum by (instance) (
  rate(node_network_receive_bytes_total{
    device!="lo"
  }[5m])
)

La unidad no corresponde al dato¶

Revisar:

La consulta.
La unidad configurada.
La escala.
Si el resultado es un ratio o un porcentaje.

Por ejemplo, esta consulta devuelve un ratio:

node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Para mostrarlo directamente como porcentaje, multiplicar por 100:

100 *
node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

El panel se ve demasiado pequeño¶

Redimensionarlo y revisar:

Leyenda.
Título.
Ejes.
Número de series.
Tamaño de fuente.

El dashboard tarda en cargar¶

Posibles causas:

Muchas consultas.
Rangos temporales demasiado amplios.
Consultas complejas.
Muchas series.
Actualización demasiado frecuente.
Transformaciones costosas.
Fuente de datos sobrecargada.

Los cambios no aparecen¶

Comprobar:

Que el panel se guardó.
Que el dashboard se guardó.
Que se está consultando el dashboard correcto.
Que no se está viendo una copia.
Que el navegador no muestra una versión antigua.

Evidencias de la práctica¶

Crear el directorio:

mkdir -p ~/laboratorio-grafana/evidencias/manipulacion-paneles

Guardar las consultas utilizadas:

cat > ~/laboratorio-grafana/evidencias/manipulacion-paneles/consultas.txt <<'EOF'
Disponibilidad:
up

Objetivos disponibles:
sum(up)

Disponibilidad global:
100 * avg(up)

Uso de CPU:
100 - (
  avg by (instance) (
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

Uso de memoria:
100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Uso de filesystem:
100 * (
  1 -
  node_filesystem_avail_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
  /
  node_filesystem_size_bytes{
    mountpoint="/",
    fstype!~"tmpfs|overlay"
  }
)

Carga del sistema:
node_load1

Tráfico recibido:
sum by (instance) (
  rate(node_network_receive_bytes_total{
    device!="lo"
  }[5m])
)
EOF

Guardar un registro de actividades:

cat > ~/laboratorio-grafana/evidencias/manipulacion-paneles/informe.txt <<'EOF'
Práctica: Manipulación de paneles

Dashboard utilizado:

Paneles creados:

Paneles editados:

Paneles duplicados:

Paneles movidos:

Paneles redimensionados:

Paneles copiados:

Paneles eliminados:

Transformaciones utilizadas:

Problemas encontrados:

Soluciones aplicadas:

Conclusiones:
EOF

Evidencias recomendadas:

01-panel-creado.png
02-panel-editado.png
03-panel-duplicado.png
04-dashboard-organizado.png
05-inspector-panel.png
06-panel-sin-datos.png
07-panel-recuperado.png
08-dashboard-final.png

Práctica integradora¶

Objetivo¶

Crear y organizar un dashboard utilizando distintas operaciones de manipulación de paneles.

Dashboard de partida¶

Utilizar o crear:

Monitorización de servidor Linux

Tareas¶

Crear paneles¶

Crear los siguientes paneles:

Estado de los objetivos
Objetivos disponibles
Uso de CPU
Uso de memoria
Uso del sistema de ficheros
Carga del sistema
Tráfico recibido

Configurar paneles¶

Configurar:

Títulos.
Descripciones.
Fuentes de datos.
Consultas.
Visualizaciones.
Unidades.
Decimales.
Límites.
Umbrales.
Leyendas.

Organizar el dashboard¶

Distribuir los paneles:

Parte superior:
- Estado de los objetivos
- Objetivos disponibles

Zona central:
- Uso de CPU
- Uso de memoria
- Uso del sistema de ficheros

Zona inferior:
- Carga del sistema
- Tráfico recibido

Manipular paneles¶

Realizar las siguientes operaciones:

Duplicar el panel de CPU.
Transformarlo en un panel de memoria.
Moverlo junto al panel de CPU.
Redimensionar ambos paneles.
Copiar el panel de disponibilidad a otro dashboard.
Eliminar un panel temporal.
Exportar el dashboard.
Utilizar el inspector.
Probar un panel sin datos.
Recuperar el panel a partir de una copia.

Tabla de resultados¶

Operación	Realizada	Observaciones
Panel creado
Fuente de datos seleccionada
Consulta configurada
Visualización seleccionada
Título configurado
Descripción añadida
Unidad configurada
Umbrales configurados
Leyenda configurada
Panel movido
Panel redimensionado
Panel duplicado
Panel copiado
Panel eliminado
Inspector utilizado
Dashboard guardado
Dashboard exportado
Panel sin datos diagnosticado
Evidencias guardadas

Puntos clave¶

Un panel combina consulta, fuente de datos y visualización.
La manipulación de paneles permite adaptar un dashboard a las necesidades del usuario.
Cada panel debe tener un objetivo claro.
Los títulos deben describir la información mostrada.
Las descripciones aportan contexto técnico.
Las unidades son necesarias para interpretar correctamente los valores.
Los umbrales ayudan a comunicar estados.
La visualización debe elegirse según el tipo de dato.
Los paneles importantes deben colocarse en la parte superior.
Los paneles relacionados deben agruparse.
Duplicar un panel facilita reutilizar configuraciones.
Copiar un panel entre dashboards requiere revisar fuentes y variables.
Eliminar un panel no elimina la métrica de Prometheus.
El inspector ayuda a diagnosticar consultas y resultados.
Los cambios importantes deben realizarse después de exportar una copia.
El dashboard debe guardarse después de modificar paneles.
Un panel sin datos puede deberse a la consulta, la fuente, el rango temporal o los objetivos.
Demasiados paneles o consultas complejas pueden afectar al rendimiento.
La legibilidad es más importante que mostrar muchas métricas.
La documentación forma parte de la configuración del panel.

Preguntas de comprobación¶

¿Qué elementos principales forman un panel?
¿Qué diferencia existe entre una consulta y una visualización?
¿Qué pasos seguirías para crear un panel?
¿Por qué es importante utilizar títulos descriptivos?
¿Qué información debe incluir una descripción?
¿Qué visualización utilizarías para mostrar un único valor?
¿Qué visualización utilizarías para representar una evolución temporal?
¿Qué unidad utilizarías para el uso de CPU?
¿Qué unidad utilizarías para el tráfico de red?
¿Qué función cumplen los umbrales?
¿Por qué deben establecerse límites mínimos y máximos?
¿Qué diferencia existe entre duplicar y copiar un panel?
¿Qué ocurre al eliminar un panel?
¿Qué precauciones tomarías antes de eliminarlo?
¿Qué utilidad tiene el inspector de paneles?
¿Qué comprobarías si un panel no muestra datos?
¿Por qué una consulta puede devolver demasiadas series?
¿Cómo reducirías el número de series mostradas?
¿Qué factores pueden hacer que un dashboard tarde en cargar?
¿Por qué es importante guardar el dashboard después de editar un panel?
¿Qué operaciones realizarías antes de modificar un dashboard crítico?
¿Qué paneles colocarías en la parte superior de un dashboard?
¿Por qué no conviene utilizar demasiados colores?
¿Qué elementos revisarías al copiar un panel a otro dashboard?
¿Qué evidencias guardarías después de la práctica?

Resultado esperado¶

Al finalizar esta sección, el alumno debe ser capaz de crear y manipular paneles siguiendo un proceso ordenado:

Crear el panel
      |
      v
Seleccionar la fuente de datos
      |
      v
Introducir la consulta
      |
      v
Seleccionar la visualización
      |
      v
Configurar título y descripción
      |
      v
Configurar unidad y umbrales
      |
      v
Probar el resultado
      |
      v
Mover y redimensionar
      |
      v
Guardar el panel
      |
      v
Guardar el dashboard
      |
      v
Exportar y documentar

El resultado final debe ser un dashboard organizado, legible y funcional, cuyos paneles puedan ser modificados, reutilizados y diagnosticados de forma controlada.