Panel Gauge¶

El panel Gauge de Grafana representa un valor dentro de un rango definido.

Su aspecto visual permite identificar rápidamente si una métrica se encuentra en una zona normal, de advertencia o crítica.

Es especialmente útil para mostrar:

Uso de CPU.
Uso de memoria.
Uso del sistema de ficheros.
Porcentaje de disponibilidad.
Porcentaje de errores.
Capacidad utilizada.
Temperatura.
Nivel de ocupación.
Progreso hacia un límite.

Un Gauge no solo muestra el valor actual. También permite situarlo visualmente entre un mínimo y un máximo.

Objetivos¶

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

Explicar la finalidad del panel Gauge.
Diferenciar un Gauge de un Stat y un Time series.
Crear un panel Gauge desde cero.
Utilizar consultas PromQL para calcular porcentajes.
Configurar valores mínimos y máximos.
Configurar unidades y decimales.
Configurar umbrales.
Seleccionar esquemas de color.
Representar el uso de CPU.
Representar el uso de memoria.
Representar el uso de almacenamiento.
Representar la disponibilidad de los objetivos.
Interpretar correctamente el indicador.
Diagnosticar un Gauge sin datos.
Identificar errores de escala.
Comparar un Gauge con un panel Bar Gauge.
Integrar varios Gauges en un dashboard operativo.

Introducción¶

El panel Gauge muestra un valor dentro de una escala.

El flujo general es:

Métricas de Prometheus
        |
        v
Consulta PromQL
        |
        v
Valor calculado
        |
        v
Escala mínima y máxima
        |
        v
Umbrales y colores
        |
        v
Panel Gauge

Ejemplo:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

La consulta puede devolver:

73.4

El panel Gauge puede representarlo como:

73.4 %

dentro de una escala:

0 % ------------------------- 100 %
          73.4 %

Con umbrales:

0 - 70 %:   Verde
70 - 90 %:  Amarillo
90 - 100 %: Rojo

Esto permite interpretar rápidamente el estado del recurso.

Cuándo utilizar un panel Gauge¶

El Gauge es apropiado cuando:

El valor actual es importante.
Existe un rango conocido.
Se desea comparar el valor con límites.
El dato puede expresarse como porcentaje.
Se necesita una indicación visual inmediata.
Los umbrales tienen significado operativo.

Ejemplos adecuados¶

100 * avg(up)

Porcentaje de disponibilidad.

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Porcentaje de memoria utilizada.

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

Porcentaje de espacio utilizado.

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

Porcentaje de CPU utilizada.

Cuándo no utilizar un panel Gauge¶

El Gauge no suele ser la mejor opción cuando se necesita:

Analizar una tendencia temporal detallada.
Comparar muchas instancias.
Mostrar decenas de series.
Consultar etiquetas y valores en detalle.
Representar una distribución.
Mostrar texto explicativo.
Analizar picos ocurridos durante un periodo largo.

En esos casos pueden ser más adecuadas otras visualizaciones:

Necesidad	Visualización recomendada
Valor actual resumido	Stat
Evolución temporal	Time series
Comparación entre elementos	Bar Gauge
Etiquetas y valores	Table
Distribución de valores	Heatmap
Documentación	Text

Diferencia entre Gauge y Stat¶

Ambos pueden mostrar un valor actual, pero el Gauge da más importancia a la relación entre el valor y su escala.

Característica	Stat	Gauge
Mostrar un valor actual	Sí	Sí
Mostrar porcentaje	Sí	Sí
Mostrar relación con un rango	Limitada	Principal función
Mostrar umbrales	Mediante color	Mediante escala y color
Mostrar una sparkline	Sí	No es su objetivo principal
Mostrar muchos elementos	Limitado	Bar Gauge suele ser mejor
Uso como indicador visual	Alto	Muy alto

Ejemplo con el mismo dato¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Como Stat:

Memoria utilizada: 73.4 %

Como Gauge:

0 % ----------- 73.4 % ---------------- 100 %
       verde       amarillo       rojo

El Stat destaca el número.

El Gauge destaca la posición del número dentro de un rango.

Diferencia entre Gauge y Bar Gauge¶

El Gauge suele estar orientado a un valor individual.

El Bar Gauge es más adecuado para comparar varios valores.

Gauge¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Uso:

Memoria utilizada en un servidor

Bar Gauge¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Uso:

Memoria utilizada por varias instancias

Si la consulta devuelve varias series, un Bar Gauge puede ofrecer una comparación más clara que un único Gauge.

Anatomía de un panel Gauge¶

Un panel Gauge puede incluir:

+--------------------------------------+
| Uso de memoria                       |
|                                      |
|              73.4 %                  |
|           [ indicador ]              |
|                                      |
| 0 %              70 %       100 %    |
+--------------------------------------+

Valor actual¶

Es el resultado de la consulta.

Ejemplo:

73.4

Unidad¶

Indica cómo debe interpretarse el valor.

Ejemplo:

Percent (0-100)

Valor mínimo¶

Define el inicio de la escala.

Para un porcentaje:

Valor máximo¶

Define el final de la escala.

Para un porcentaje:

Umbrales¶

Dividen la escala en zonas.

Ejemplo:

0      Verde
70     Amarillo
90     Rojo

Colores¶

Representan visualmente el estado del valor.

Una convención habitual es:

Verde: normal
Amarillo: advertencia
Rojo: crítico

Decimales¶

Controlan la precisión mostrada.

Ejemplo:

73.4 %

en lugar de:

73.438291 %

Crear un panel Gauge¶

Procedimiento general¶

Acceder a Grafana.
Abrir un dashboard.
Añadir un panel.
Seleccionar Prometheus.
Introducir una consulta PromQL.
Seleccionar la visualización Gauge.
Configurar la unidad.
Definir el mínimo.
Definir el máximo.
Configurar los umbrales.
Configurar los decimales.
Añadir una descripción.
Revisar el resultado.
Guardar el panel.
Guardar el dashboard.

Consulta inicial recomendada¶

Para una primera prueba:

100 * avg(up)

Configuración:

Título: Disponibilidad global
Visualización: Gauge
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Configurar la escala¶

Escala de porcentaje¶

Para valores expresados entre 0 y 100:

Mínimo: 0
Máximo: 100

Ejemplos:

CPU.
Memoria.
Almacenamiento.
Disponibilidad.
Porcentaje de errores.

Escala de proporción¶

Una consulta como esta devuelve un valor entre 0 y 1:

node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Si se utiliza esta consulta, la unidad debe configurarse como una proporción o la consulta debe multiplicarse por 100.

Opción recomendada:

100 *
node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Unidad:

Percent (0-100)

Escala de bytes¶

Para mostrar memoria disponible:

node_memory_MemAvailable_bytes

La escala no debe fijarse automáticamente entre 0 y 100.

Utilizar:

Unidad: Bytes (IEC)
Mínimo: 0
Máximo: Automático

Escala de carga¶

Para la carga del sistema:

node_load1

La carga no es un porcentaje.

Configuración recomendada:

Unidad: None
Mínimo: 0
Máximo: Automático

El máximo puede depender de la capacidad del sistema y del objetivo del dashboard.

Configurar unidades¶

Uso de CPU¶

Consulta:

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

Configuración:

Unidad: Percent (0-100)

Uso de memoria¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Configuración:

Unidad: Percent (0-100)

Uso de almacenamiento¶

Consulta:

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

Configuración:

Unidad: Percent (0-100)

Disponibilidad¶

Consulta:

100 * avg(up)

Configuración:

Unidad: Percent (0-100)

Temperatura¶

Si existe una métrica de temperatura:

node_hwmon_temp_celsius

Configuración:

Unidad: Celsius

Tráfico de red¶

Consulta:

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

Configuración:

Unidad: bytes/sec

Configurar umbrales¶

Los umbrales determinan el estado visual del Gauge.

Uso de CPU¶

Consulta:

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

Umbrales:

0      Verde
70     Amarillo
90     Rojo

Interpretación:

0 - 69.99 %    Uso normal
70 - 89.99 %   Uso elevado
90 - 100 %     Uso crítico

Uso de memoria¶

Umbrales habituales:

0      Verde
70     Amarillo
90     Rojo

Uso de almacenamiento¶

Los discos pueden requerir umbrales más estrictos:

0      Verde
80     Amarillo
90     Rojo

Disponibilidad¶

Para una disponibilidad global:

0      Rojo
90     Amarillo
99     Verde

Importancia de documentar los umbrales¶

Los valores deben estar justificados.

No siempre los mismos umbrales son válidos para todos los sistemas:

Un servidor de desarrollo.
Un servidor de producción.
Un sistema con poco almacenamiento.
Un sistema de procesamiento intensivo.
Un equipo con alta disponibilidad.

Configurar colores¶

Los colores deben expresar estados, no decorar el panel.

Convención habitual:

Verde: situación normal
Amarillo: advertencia
Rojo: situación crítica

Ejemplo¶

Uso de memoria: 45 % → verde
Uso de memoria: 78 % → amarillo
Uso de memoria: 94 % → rojo

Errores frecuentes¶

No se debe:

Utilizar rojo para todos los valores altos sin analizar el contexto.
Usar colores diferentes para el mismo significado.
Mezclar escalas entre paneles.
Utilizar colores sin documentarlos.
Confundir ausencia de datos con estado normal.

Configurar decimales¶

Los decimales dependen de la métrica.

Métrica	Decimales recomendados
CPU	1
Memoria	1
Almacenamiento	1
Disponibilidad	1 o 2
Carga	2
Temperatura	1
Tráfico	1 o 2

Ejemplo:

Uso de CPU: 73.4 %

es más fácil de leer que:

Uso de CPU: 73.438291 %

Configurar el modo de visualización¶

El Gauge puede configurarse con distintos estilos visuales.

Según la versión de Grafana, pueden estar disponibles opciones como:

Gauge radial.
Barra.
Indicador horizontal.
Indicador vertical.
Arco.
Escala con valor central.

La selección debe depender del espacio disponible y de la cantidad de información.

Gauge radial¶

Adecuado para:

Paneles pequeños.
Indicadores individuales.
Porcentajes.
Uso de memoria.

Barra horizontal¶

Adecuada para:

Paneles más anchos.
Comparaciones sencillas.
Integración con otros indicadores.

Escala con valor¶

Adecuada cuando:

Los límites deben ser muy visibles.
El valor actual necesita contexto.
Se quiere facilitar la lectura del rango.

Configurar el texto del Gauge¶

El Gauge puede mostrar:

Valor.
Unidad.
Nombre.
Valor y nombre.
Texto personalizado mediante mapas de valores.

Solo valor¶

73.4 %

Valor y nombre¶

Memoria utilizada: 73.4 %

Nombre del campo¶

Para una consulta agrupada:

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

Se puede mostrar:

{{instance}}

Esto resulta útil cuando se trabaja con una instancia concreta.

Consultas PromQL para Gauge¶

Disponibilidad global¶

100 * avg(up)

Disponibilidad de Node Exporter¶

100 * avg(up{job="node_exporter"})

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 memoria por instancia¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Uso del sistema de ficheros raíz¶

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

Carga del sistema¶

node_load1

Temperatura¶

Si Node Exporter expone la métrica:

node_hwmon_temp_celsius

Tráfico recibido¶

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

Ejemplo completo 1: Gauge de disponibilidad¶

Objetivo¶

Mostrar el porcentaje global de objetivos disponibles.

Consulta¶

100 * avg(up)

Configuración¶

Título: Disponibilidad global
Visualización: Gauge
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Umbrales¶

0      Rojo
90     Amarillo
99     Verde

Descripción¶

Porcentaje de objetivos disponibles en el último scraping.
Los objetivos con valor 1 se consideran disponibles.

Resultado esperado¶

Si todos los objetivos están activos:

100.0 %

Ejemplo completo 2: Gauge de CPU¶

Objetivo¶

Mostrar el porcentaje de CPU utilizado.

Consulta¶

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

Configuración¶

Título: Uso de CPU
Visualización: Gauge
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Umbrales¶

0      Verde
70     Amarillo
90     Rojo

Descripción¶

Porcentaje medio de CPU utilizada durante los últimos cinco minutos.
El cálculo se realiza a partir del tiempo de CPU en modo idle.

Consideración¶

Si la consulta devuelve una serie por instancia, el Gauge puede mostrar varios resultados o aplicar una reducción.

Para mostrar una única instancia:

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

Para mantener el detalle por instancia, puede ser más adecuado utilizar:

Bar Gauge

o:

Time series

Ejemplo completo 3: Gauge de memoria¶

Objetivo¶

Mostrar el porcentaje de memoria utilizada.

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)
Mínimo: 0
Máximo: 100
Decimales: 1

Umbrales¶

0      Verde
70     Amarillo
90     Rojo

Descripción¶

Porcentaje de memoria utilizada por el sistema.
Los valores superiores al 90 % deben investigarse.

Ejemplo completo 4: Gauge de almacenamiento¶

Objetivo¶

Mostrar el uso del sistema de ficheros raíz.

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)
Mínimo: 0
Máximo: 100
Decimales: 1

Umbrales¶

0      Verde
80     Amarillo
90     Rojo

Comparación con el sistema operativo¶

df -h /

Descripción¶

Porcentaje de espacio utilizado en el sistema de ficheros raíz.
Se excluyen los tipos tmpfs y overlay.

Ejemplo completo 5: Gauge de capacidad disponible¶

Un Gauge también puede utilizarse para mostrar capacidad disponible en vez de capacidad utilizada.

Consulta¶

100 *
node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Configuración¶

Título: Memoria disponible
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Umbrales¶

En este caso, un valor alto suele ser positivo:

0      Rojo
10     Amarillo
30     Verde

La interpretación depende del sentido de la métrica.

Para memoria disponible:

Valor bajo: problema
Valor alto: situación normal

Para memoria utilizada:

Valor bajo: situación normal
Valor alto: problema

Es fundamental que el título y la descripción indiquen si se está mostrando:

Uso

o:

Disponibilidad

Ejemplo de sesión 1: crear un Gauge básico¶

Objetivo¶

Crear un Gauge para representar la disponibilidad global.

Pasos¶

Acceder a Grafana:

http://localhost:3000

Abrir un dashboard.
Añadir un panel.
Seleccionar Prometheus.
Introducir:

100 * avg(up)

Seleccionar la visualización Gauge.
Configurar:

Título: Disponibilidad global
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Configurar los umbrales:

0      Rojo
90     Amarillo
99     Verde

Guardar el panel.
Guardar el dashboard.

Actividades¶

Anota el valor mostrado.
Comprueba el resultado directamente en Prometheus.
Explica la posición del indicador.
Describe el significado de cada color.
Añade una descripción al panel.

Ejemplo de sesión 2: crear un Gauge de memoria¶

Objetivo¶

Representar el porcentaje de memoria utilizada.

Consulta¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Pasos¶

Crear un panel nuevo.
Seleccionar Prometheus.
Introducir la consulta.
Seleccionar Gauge.
Configurar:

Título: Uso de memoria
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Configurar:

0      Verde
70     Amarillo
90     Rojo

Guardar el panel.
Guardar el dashboard.

Actividades¶

Comprueba la memoria utilizada con:

free -h

Compara el resultado.
Explica posibles diferencias.
Cambia temporalmente la unidad.
Restaura la configuración correcta.

Ejemplo de sesión 3: crear un Gauge de CPU¶

Objetivo¶

Representar el uso actual de CPU.

Consulta¶

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

Pasos¶

Crear un Gauge.
Introducir la consulta.
Configurar:

Título: Uso medio de CPU
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Configurar umbrales:

0      Verde
70     Amarillo
90     Rojo

Guardar el panel.

Generar carga¶

Ejecutar:

yes > /dev/null &

Observar el Gauge y detener la carga:

pkill yes

Actividades¶

Anota el valor inicial.
Genera carga.
Observa el cambio.
Comprueba el color.
Detén la carga.
Observa la recuperación.
Explica el uso de rate().

Ejemplo de sesión 4: crear un Gauge de almacenamiento¶

Objetivo¶

Mostrar el porcentaje utilizado en /.

Pasos¶

Crear un panel Gauge.
Introducir:

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

Configurar:

Título: Uso del sistema de ficheros raíz
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100
Decimales: 1

Configurar umbrales:

0      Verde
80     Amarillo
90     Rojo

Comparar con:

df -h /

Actividades¶

Identifica el valor mostrado.
Compara PromQL con df -h.
Explica por qué se excluyen tmpfs y overlay.
Añade una descripción.
Guarda una captura.

Ejemplo de sesión 5: comparar escalas incorrectas y correctas¶

Objetivo¶

Observar los problemas producidos por una escala incorrecta.

Consulta¶

100 * avg(up)

Configuración incorrecta¶

Mínimo: 0
Máximo: 1
Unidad: Percent (0-100)

El Gauge puede mostrar una representación incorrecta porque la consulta devuelve valores entre 0 y 100, pero la escala termina en 1.

Configuración correcta¶

Mínimo: 0
Máximo: 100
Unidad: Percent (0-100)

Actividades¶

Configura intencionadamente la escala incorrecta.
Observa el resultado.
Corrige el máximo.
Comprueba el cambio.
Explica la relación entre:
Consulta.
Unidad.
Escala.
Umbrales.

Ejemplo de sesión 6: comparar uso y disponibilidad¶

Objetivo¶

Comprender que una misma métrica puede tener interpretaciones diferentes según la consulta.

Panel 1: memoria utilizada¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Título:

Memoria utilizada

Umbrales:

0      Verde
70     Amarillo
90     Rojo

Panel 2: memoria disponible¶

100 *
node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Título:

Memoria disponible

Umbrales:

0      Rojo
10     Amarillo
30     Verde

Actividades¶

Crea ambos Gauges.
Colócalos juntos.
Compara los valores.
Comprueba que uno es aproximadamente el complemento del otro.
Explica por qué los umbrales deben invertirse.
Añade descripciones claras.

Ejemplo de sesión 7: comparar Gauge y Bar Gauge¶

Objetivo¶

Determinar qué visualización es más adecuada para uno o varios servidores.

Consulta¶

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

Panel Gauge¶

Utilizarlo cuando:

Solo se necesita mostrar un valor agregado.

Panel Bar Gauge¶

Utilizarlo cuando:

Se desea comparar el uso de CPU por instancia.

Actividades¶

Crea un Gauge con una consulta agregada.
Crea un Bar Gauge con una serie por instancia.
Configura los mismos umbrales.
Compara ambos paneles.
Justifica cuál es más adecuado para:
Un resumen general.
Comparar servidores.
Analizar la evolución temporal.

Ejemplo de sesión 8: diagnosticar un Gauge sin datos¶

Objetivo¶

Identificar un problema de consulta o de conectividad.

Consulta incorrecta¶

metrica_inexistente_para_gauge

Pasos¶

Crear un panel Gauge.
Introducir la consulta incorrecta.
Observar el resultado.
Abrir el inspector del panel.
Revisar los datos devueltos.
Probar:

up

Probar:

node_memory_MemAvailable_bytes

Restaurar la consulta original.

Actividades¶

Diferenciar entre:

Valor 0
Sin datos
Error de consulta
Error de conexión

Documentar:

Consulta utilizada.
Resultado.
Error observado.
Diagnóstico.
Solución aplicada.

Ejemplo de sesión 9: crear un bloque de Gauges¶

Objetivo¶

Crear un resumen visual de los recursos principales.

Crear los siguientes paneles:

Panel	Consulta	Unidad
Disponibilidad global	`100 * avg(up)`	Percent
Uso de CPU	Consulta de CPU	Percent
Uso de memoria	Consulta de memoria	Percent
Uso de almacenamiento	Consulta de filesystem	Percent

Distribución¶

+----------------------+-------------------------------+
| Disponibilidad       | Uso de CPU                    |
+----------------------+-------------------------------+
| Uso de memoria       | Uso de almacenamiento         |
+----------------------+-------------------------------+

Actividades¶

Crea los cuatro Gauges.
Utiliza una escala de 0 a 100.
Configura umbrales coherentes.
Utiliza títulos descriptivos.
Añade descripciones.
Comprueba el dashboard en pantalla completa.
Guarda una captura.

Ejemplo de sesión 10: verificar los valores mediante la API¶

Objetivo¶

Comparar el valor mostrado en Grafana con el valor devuelto por Prometheus.

Disponibilidad¶

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode 'query=100 * avg(up)' \
  | jq

Memoria utilizada¶

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode \
  'query=100 * (1 - node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes)' \
  | jq

Almacenamiento utilizado¶

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode \
  'query=100 * (1 - node_filesystem_avail_bytes{mountpoint="/",fstype!~"tmpfs|overlay"} / node_filesystem_size_bytes{mountpoint="/",fstype!~"tmpfs|overlay"})' \
  | jq

Actividades¶

Ejecuta las consultas.
Compara los valores con Grafana.
Explica pequeñas diferencias temporales.
Comprueba que las unidades coinciden.
Guarda los resultados como evidencia.

Buenas prácticas¶

Utilizar siempre una escala coherente¶

Si la consulta devuelve porcentajes entre 0 y 100:

Mínimo: 0
Máximo: 100

Explicar si el valor representa uso o disponibilidad¶

No es lo mismo:

Memoria utilizada

que:

Memoria disponible

Los umbrales pueden ser opuestos.

Configurar títulos descriptivos¶

Utilizar:

Uso de CPU
Uso de memoria
Uso del sistema de ficheros raíz
Disponibilidad global

Mantener los mismos umbrales cuando las métricas sean comparables¶

Por ejemplo, CPU y memoria pueden utilizar:

0      Verde
70     Amarillo
90     Rojo

Aunque los umbrales deben ajustarse al contexto.

Combinar Gauges con Time series¶

El Gauge muestra el estado actual.

El Time series muestra la evolución.

Una combinación recomendada:

Gauge: uso actual
Time series: tendencia de la última hora

Evitar demasiados Gauges¶

Un dashboard lleno de indicadores puede resultar visualmente pesado.

Mostrar únicamente los indicadores principales.

Documentar la unidad¶

El usuario debe saber si el valor representa:

Porcentaje.
Bytes.
Bytes por segundo.
Grados.
Carga.
Número absoluto.

Probar valores normales y críticos¶

El panel debe revisarse con:

Valor bajo.
Valor intermedio.
Valor alto.
Objetivo caído.
Sin datos.

Problemas habituales¶

El Gauge aparece vacío¶

Comprobar:

up

Después:

node_memory_MemAvailable_bytes

Revisar:

Fuente de datos.
Consulta.
Rango temporal.
Estado de los targets.
Variables.
Etiquetas.
Inspector del panel.

El indicador supera el máximo¶

Posibles causas:

La consulta devuelve un porcentaje entre 0 y 1, pero la unidad espera 0 a 100.
El máximo está configurado incorrectamente.
La consulta no se ha multiplicado por 100.
Se ha aplicado una transformación incorrecta.

Ejemplo de ratio:

node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Ejemplo de porcentaje:

100 *
node_memory_MemAvailable_bytes
/
node_memory_MemTotal_bytes

Todo aparece en rojo¶

Comprobar:

Umbrales.
Escala.
Orden de los colores.
Valor mínimo.
Valor máximo.
Tipo de métrica.

El color parece invertido¶

Puede ocurrir cuando se muestra disponibilidad en lugar de uso.

Para uso:

Valor alto: peor

Para disponibilidad:

Valor alto: mejor

Los umbrales deben adaptarse al sentido del indicador.

El Gauge muestra varias series¶

La consulta devuelve varios resultados.

Soluciones:

Agregar la consulta.
Filtrar por instancia.
Utilizar Bar Gauge.
Utilizar Time series.
Configurar una reducción.

Ejemplo agregado:

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

La unidad no coincide con la consulta¶

Revisar si la consulta devuelve:

0 - 1

o:

0 - 100

No utilizar una unidad de porcentaje de 0 a 100 con una consulta que devuelve una proporción de 0 a 1 sin configurar correctamente la escala.

El Gauge no muestra una tendencia¶

El Gauge no está diseñado para mostrar una evolución temporal detallada.

Utilizar un panel:

Time series

como complemento.

El valor parece antiguo¶

Comprobar:

Última muestra.
Estado del target.
Intervalo de scraping.
Rango temporal.
Uso de datos no nulos.
Fecha y hora del sistema.

Evidencias de la práctica¶

Crear el directorio:

mkdir -p ~/laboratorio-grafana/evidencias/panel-gauge

Guardar las consultas:

cat > ~/laboratorio-grafana/evidencias/panel-gauge/consultas-promql.txt <<'EOF'
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 almacenamiento:
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(
  rate(node_network_receive_bytes_total{
    device!="lo"
  }[5m])
)
EOF

Guardar el resultado de la disponibilidad:

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode 'query=100 * avg(up)' \
  | jq \
  > ~/laboratorio-grafana/evidencias/panel-gauge/disponibilidad.json

Guardar un informe:

cat > ~/laboratorio-grafana/evidencias/panel-gauge/informe.txt <<'EOF'
Práctica: Panel Gauge

Dashboard utilizado:

Gauges creados:

Consultas utilizadas:

Unidades configuradas:

Valores mínimos:

Valores máximos:

Umbrales configurados:

Prueba con carga de CPU:

Prueba de caída de Node Exporter:

Resultado de la recuperación:

Problemas encontrados:

Soluciones aplicadas:

Conclusiones:
EOF

Capturas recomendadas:

01-gauge-disponibilidad.png
02-gauge-cpu.png
03-gauge-memoria.png
04-gauge-almacenamiento.png
05-gauge-escala-correcta.png
06-gauge-escala-incorrecta.png
07-gauge-sin-datos.png
08-gauge-dashboard-final.png

Práctica integradora¶

Objetivo¶

Crear un dashboard compuesto por Gauges que muestre el estado actual de los principales recursos de un servidor Linux.

Panel 1: disponibilidad¶

Consulta:

100 * avg(up)

Configuración:

Título: Disponibilidad global
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Umbrales:

0      Rojo
90     Amarillo
99     Verde

Panel 2: CPU¶

Consulta:

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

Configuración:

Título: Uso de CPU
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Umbrales:

0      Verde
70     Amarillo
90     Rojo

Panel 3: memoria¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Configuración:

Título: Uso de memoria
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Umbrales:

0      Verde
70     Amarillo
90     Rojo

Panel 4: 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
Unidad: Percent (0-100)
Mínimo: 0
Máximo: 100

Umbrales:

0      Verde
80     Amarillo
90     Rojo

Distribución propuesta¶

+----------------------+-------------------------------+
| Disponibilidad       | Uso de CPU                    |
+----------------------+-------------------------------+
| Uso de memoria       | Uso de almacenamiento         |
+----------------------+-------------------------------+

Tareas¶

Crear los cuatro Gauges.
Configurar las consultas.
Configurar las unidades.
Configurar los valores mínimos y máximos.
Configurar los umbrales.
Añadir títulos descriptivos.
Añadir descripciones.
Comparar los valores con el sistema operativo.
Generar carga de CPU.
Observar los cambios.
Detener Node Exporter.
Observar el Gauge de disponibilidad.
Iniciar Node Exporter.
Comprobar la recuperación.
Guardar capturas.
Exportar el dashboard.
Completar el informe.

Tabla de resultados¶

Comprobación	Resultado	Observaciones
Gauge de disponibilidad creado
Gauge de CPU creado
Gauge de memoria creado
Gauge de almacenamiento creado
Fuente de datos correcta
Unidad configurada
Valor mínimo configurado
Valor máximo configurado
Umbrales configurados
Descripciones añadidas
Escala comprobada
Prueba de CPU realizada
Prueba de caída realizada
Recuperación comprobada
Dashboard exportado
Evidencias guardadas

Puntos clave¶

El panel Gauge representa un valor dentro de un rango.
Es adecuado para porcentajes, capacidades y niveles de utilización.
La consulta, la unidad y la escala deben ser coherentes.
Un porcentaje puede expresarse entre 0 y 100.
Una proporción puede expresarse entre 0 y 1.
Si la consulta devuelve una proporción, debe ajustarse la unidad o multiplicarse por 100.
Los valores mínimos y máximos definen la escala visual.
Los umbrales dividen la escala en estados.
El significado de los colores debe documentarse.
Uso y disponibilidad tienen interpretaciones opuestas.
Un Gauge es adecuado para un valor individual.
Un Bar Gauge es más adecuado para comparar varias series.
Un Time series es más adecuado para analizar tendencias.
Los Gauges deben utilizar títulos descriptivos.
Los decimales deben limitarse a la precisión necesaria.
Un Gauge vacío puede deberse a una consulta, una fuente o un target con problemas.
0, No data y Error representan situaciones diferentes.
Los umbrales visuales no sustituyen necesariamente a las alertas.
El dashboard debe probarse con valores normales y situaciones de error.
La documentación de unidades, escalas y umbrales facilita el mantenimiento.

Preguntas de comprobación¶

¿Qué finalidad tiene un panel Gauge?
¿Qué diferencia existe entre un Gauge y un Stat?
¿Qué diferencia existe entre un Gauge y un Bar Gauge?
¿Qué diferencia existe entre un Gauge y un Time series?
¿Qué tipo de métricas son adecuadas para un Gauge?
¿Qué unidad utilizarías para representar el uso de CPU?
¿Qué valores mínimos y máximos utilizarías para un porcentaje?
¿Qué ocurre si una consulta devuelve valores entre 0 y 1 pero el Gauge está configurado entre 0 y 100?
¿Cómo convertirías una proporción en un porcentaje?
¿Qué función cumplen los umbrales?
¿Qué colores utilizarías para normal, advertencia y crítico?
¿Por qué los umbrales de memoria utilizada y memoria disponible pueden ser diferentes?
¿Qué consulta utilizarías para calcular el uso de memoria?
¿Qué consulta utilizarías para calcular el uso del sistema de ficheros?
¿Por qué se excluyen normalmente tmpfs y overlay?
¿Qué revisarías si el Gauge aparece vacío?
¿Qué revisarías si el Gauge aparece siempre en rojo?
¿Qué diferencias existen entre 0, No data y Error?
¿Cuándo utilizarías un Bar Gauge en lugar de un Gauge?
¿Cuándo utilizarías un Time series en lugar de un Gauge?
¿Qué información incluirías en la descripción del panel?
¿Por qué es importante configurar correctamente la unidad?
¿Cómo comprobarías el valor mostrado por Grafana desde la terminal?
¿Qué evidencias guardarías durante la práctica?
¿Qué características debe tener un Gauge bien configurado?

Resultado esperado¶

Al finalizar esta sección, el alumno debe ser capaz de crear y configurar paneles Gauge coherentes y útiles.

El proceso completo será:

Seleccionar una métrica
        |
        v
Crear una consulta PromQL
        |
        v
Determinar la escala del resultado
        |
        v
Seleccionar Gauge
        |
        v
Configurar unidad
        |
        v
Configurar mínimo y máximo
        |
        v
Configurar umbrales y colores
        |
        v
Añadir título y descripción
        |
        v
Probar valores normales y críticos
        |
        v
Guardar y documentar

El resultado final debe ser un conjunto de indicadores Gauge que permita conocer rápidamente el estado actual de la disponibilidad, la CPU, la memoria y el almacenamiento del sistema monitorizado.