Panel Stat¶

El panel Stat de Grafana permite representar un valor resumido de forma destacada.

Es adecuado para mostrar el estado actual de una métrica, un contador, un porcentaje o un indicador principal. Su objetivo es que el usuario pueda interpretar rápidamente una situación sin analizar un gráfico completo.

Ejemplos de información apropiada para un panel Stat:

Número de objetivos disponibles.
Porcentaje de disponibilidad.
Cantidad de alertas activas.
Memoria disponible.
Número de servidores monitorizados.
Estado de un servicio.
Valor actual de una métrica.

Objetivos¶

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

Explicar la finalidad del panel Stat.
Diferenciar un panel Stat de un Gauge o un Time series.
Crear un panel Stat desde cero.
Seleccionar una fuente de datos.
Introducir consultas PromQL.
Configurar la reducción de series.
Mostrar el valor actual, mínimo, máximo o promedio.
Configurar unidades y decimales.
Configurar colores y umbrales.
Utilizar mapas de valores.
Configurar el texto de un panel Stat.
Mostrar una mini-gráfica de tendencia.
Configurar el comportamiento ante valores nulos.
Interpretar los estados No data, Null y Error.
Crear indicadores de disponibilidad.
Crear indicadores de capacidad.
Diagnosticar un panel Stat sin datos.
Integrar paneles Stat en un dashboard operativo.

Introducción¶

Un panel Stat muestra principalmente un valor reducido.

El flujo habitual es:

Métricas de Prometheus
        |
        v
Consulta PromQL
        |
        v
Una o varias series
        |
        v
Reducción del resultado
        |
        v
Valor mostrado
        |
        v
Panel Stat

Por ejemplo, la consulta:

sum(up)

puede devolver:

El panel Stat puede mostrar:

con el título:

Objetivos disponibles

Otro ejemplo:

100 * avg(up)

puede devolver:

El panel Stat puede mostrarlo como:

100 %

con el título:

Disponibilidad global

El panel Stat está pensado para responder rápidamente a una pregunta concreta:

¿Cuál es el valor actual?

No es la mejor visualización para analizar en detalle cómo ha evolucionado una métrica. Para eso suele ser más adecuado un panel Time series.

Cuándo utilizar un panel Stat¶

El panel Stat es apropiado cuando:

Se necesita mostrar un único valor.
El valor actual es más importante que su evolución.
Se quiere destacar un indicador principal.
Se desea crear una tarjeta de resumen.
El resultado debe interpretarse rápidamente.
La métrica puede resumirse mediante una agregación.
Se desea mostrar una tendencia pequeña junto al valor actual.

Ejemplos adecuados¶

sum(up)

Número de objetivos disponibles.

count(up)

Número total de objetivos conocidos.

100 * avg(up)

Porcentaje medio de disponibilidad.

node_load1

Carga actual del sistema.

node_memory_MemAvailable_bytes

Memoria disponible.

count(node_cpu_seconds_total{mode="idle"})

Número de series de CPU en modo idle.

Cuándo no utilizar un panel Stat¶

No suele ser la mejor opción cuando se necesita:

Analizar una tendencia detallada.
Comparar muchos puntos temporales.
Mostrar muchas series.
Observar picos y caídas.
Consultar etiquetas de forma extensa.
Ver la distribución de valores.
Representar una relación compleja entre variables.

Para esos casos pueden ser más apropiados:

Necesidad	Visualización recomendada
Evolución temporal	Time series
Comparación entre servidores	Bar Gauge o Table
Valor frente a un rango	Gauge
Datos con etiquetas	Table
Distribución	Heatmap
Texto contextual	Text

Anatomía de un panel Stat¶

Un panel Stat puede incluir los siguientes elementos:

+--------------------------------------+
| Título                               |
|                                      |
|              85 %                    |
|                                      |
|     tendencia o sparkline            |
|                                      |
| Descripción o unidad                 |
+--------------------------------------+

Título¶

Identifica el indicador.

Ejemplos:

Objetivos disponibles
Disponibilidad global
Memoria libre
Carga del sistema
Alertas activas

Valor principal¶

Es el dato más importante del panel.

Ejemplos:

2
100 %
4.25 GiB
0

Unidad¶

Aclara cómo debe interpretarse el valor.

Ejemplos:

%
bytes
GiB
seconds
none

Decimales¶

Controlan la precisión visual.

Ejemplo:

85.4 %

en lugar de:

85.437829 %

Sparkline¶

Una sparkline es una pequeña representación de la evolución temporal del valor.

Permite mostrar:

Si el valor está aumentando.
Si está disminuyendo.
Si permanece estable.
Si ha tenido picos recientes.

La sparkline proporciona contexto, pero no sustituye a un gráfico temporal detallado.

Umbrales¶

Cambian el color del valor según su magnitud.

Ejemplo:

0     Verde
70    Amarillo
90    Rojo

Mapa de valores¶

Permite sustituir valores numéricos por texto.

Ejemplo:

1 → ACTIVO
0 → CAÍDO

Texto de valor¶

Puede configurarse para mostrar:

El valor.
El nombre de la métrica.
El nombre corto.
El nombre y el valor.
Un texto definido mediante un mapa de valores.

Diferencia entre Stat y Gauge¶

Ambos pueden mostrar un valor resumido, pero tienen objetivos diferentes.

Característica	Stat	Gauge
Valor resumido	Muy adecuado	Adecuado
Comparación con un rango	Mediante color	Visual y explícita
Mostrar valor actual	Sí	Sí
Mostrar mini-tendencia	Sí	Normalmente no es su función principal
Mostrar límites	Mediante configuración	Parte central de la visualización
Comparar muchos elementos	Limitado	Bar Gauge suele ser mejor
Uso en tarjetas de resumen	Muy adecuado	Menos habitual

Ejemplo¶

Para mostrar el número de objetivos:

sum(up)

Utilizar:

Stat

Para mostrar el porcentaje de memoria utilizado con relación a un rango de 0 a 100:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Puede utilizarse:

Gauge

Diferencia entre Stat y Time series¶

El panel Stat muestra principalmente el valor reducido actual.

El panel Time series muestra cómo cambia el valor a lo largo del tiempo.

Stat¶

Consulta:

node_load1

Resultado:

0.42

Pregunta que responde:

¿Cuál es la carga actual?

Time series¶

Consulta:

node_load1

Pregunta que responde:

¿Cómo ha evolucionado la carga durante la última hora?

Una buena práctica consiste en utilizar ambos paneles cuando se necesita resumen y contexto:

Panel Stat: valor actual
Panel Time series: evolución temporal

Crear un panel Stat¶

Procedimiento general¶

Acceder a Grafana.
Abrir un dashboard.
Añadir un panel.
Seleccionar la fuente de datos Prometheus.
Introducir una consulta.
Seleccionar la visualización Stat.
Configurar el cálculo del valor.
Configurar la unidad.
Configurar los decimales.
Configurar los umbrales.
Añadir una descripción.
Revisar el resultado.
Guardar el panel.
Guardar el dashboard.

Consulta inicial¶

Para una primera prueba, utilizar:

sum(up)

Configuración recomendada:

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

Configurar la reducción de datos¶

Una consulta puede devolver varias series o varios valores.

El panel Stat necesita decidir qué valor debe mostrar.

Para ello se utiliza una reducción.

Reducciones habituales¶

Reducción	Función
Last	Último valor
Last not null	Último valor que no sea nulo
Mean	Promedio
Min	Valor mínimo
Max	Valor máximo
Sum	Suma
Count	Número de valores
First	Primer valor
Range	Diferencia entre máximo y mínimo

Ejemplo con varias series¶

Consulta:

up

Puede devolver:

prometheus      1
node_exporter   1

Si el panel utiliza Last, mostrará uno de los últimos valores.

Si se desea mostrar el total disponible, es más claro modificar la consulta:

sum(up)

La consulta ya devuelve un único valor:

Recomendación¶

Cuando sea posible, preparar el resultado desde PromQL.

Ejemplos:

sum(up)

100 * avg(up)

max(node_load1)

Esto hace que el propósito del panel sea más explícito.

Configurar el valor actual¶

Para mostrar el valor más reciente, utilizar una reducción equivalente a:

Last

o:

Last not null

Diferencia¶

Last¶

Muestra el último valor recibido, aunque pueda ser nulo según el resultado.

Last not null¶

Busca el último valor disponible que no sea nulo.

Para indicadores operativos suele ser preferible:

Last not null

Sin embargo, no debe ocultarse indefinidamente la ausencia de datos. Un panel que conserva un valor antiguo puede dar una falsa sensación de normalidad.

Configurar la unidad¶

Disponibilidad como número¶

Consulta:

sum(up)

Unidad:

None

Disponibilidad como porcentaje¶

Consulta:

100 * avg(up)

Unidad:

Percent (0-100)

Memoria disponible¶

Consulta:

node_memory_MemAvailable_bytes

Unidad:

Bytes (IEC)

Carga del sistema¶

Consulta:

node_load1

Unidad:

None

Tráfico de red¶

Consulta:

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

Unidad:

bytes/sec

Configurar decimales¶

La cantidad de decimales debe adaptarse al dato.

Ejemplos¶

Objetivos disponibles: 0 decimales
Disponibilidad: 1 o 2 decimales
Carga del sistema: 2 decimales
Memoria: automático
Tráfico: 1 o 2 decimales

Ejemplo incorrecto¶

Disponibilidad global: 99.837492 %

Ejemplo recomendado¶

Disponibilidad global: 99.8 %

Los decimales innecesarios dificultan la lectura y no siempre aportan precisión útil.

Configurar colores y umbrales¶

El panel Stat puede cambiar de color según:

Umbral.
Valor de texto.
Estado.
Configuración fija.

Ejemplo: disponibilidad¶

Consulta:

100 * avg(up)

Configuración:

0      Rojo
90     Amarillo
99     Verde

Interpretación:

0 - 89.99 %    Crítico
90 - 98.99 %   Advertencia
99 - 100 %     Normal

Ejemplo: objetivos disponibles¶

Consulta:

sum(up)

Si se conoce el número esperado de objetivos, se pueden definir umbrales.

Supongamos que se esperan dos objetivos:

0      Rojo
1      Amarillo
2      Verde

Ejemplo: uso de memoria¶

Consulta:

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Umbrales:

0      Verde
70     Amarillo
90     Rojo

Consideración importante¶

Los umbrales de un panel comunican visualmente un estado, pero no sustituyen necesariamente una regla de alerta.

Configurar mapas de valores¶

Los mapas de valores permiten presentar un valor técnico como un texto comprensible.

Mapa básico de disponibilidad¶

Consulta:

up{job="node_exporter"}

Mapa:

1 → UP
0 → DOWN

El panel puede mostrar:

UP

o:

DOWN

Mapa con colores¶

Configurar:

UP   → verde
DOWN → rojo

Ventajas¶

Mejora la interpretación.
Reduce la dependencia de números.
Facilita la lectura para usuarios no técnicos.
Permite crear indicadores operativos.

Precauciones¶

El mapa debe cubrir los valores esperados.
Los valores no contemplados deben tener un comportamiento claro.
No se debe ocultar información importante.
Debe documentarse el significado de cada estado.

Configurar el nombre del campo¶

Cuando la consulta devuelve una serie con etiquetas, el panel puede mostrar un nombre automático poco claro.

Ejemplo:

{instance="localhost:9100", job="node_exporter"}

Es preferible configurar un nombre más comprensible:

Node Exporter

o utilizar una plantilla basada en etiquetas:

{{job}}

Para una consulta agrupada por instancia:

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

Se puede utilizar:

{{instance}}

Configurar una sparkline¶

La sparkline muestra una pequeña tendencia junto al valor principal.

Es útil para detectar:

Incrementos recientes.
Descensos.
Oscilaciones.
Cambios bruscos.
Estabilidad.

Ejemplo¶

Consulta:

node_load1

Configuración:

Visualización: Stat
Sparkline: Activada
Título: Carga actual del sistema
Unidad: None
Decimales: 2

La sparkline no debe interpretarse como un sustituto de un gráfico temporal.

Para analizar con detalle la evolución, utilizar un panel Time series.

Configurar el texto mostrado¶

El panel Stat puede mostrar diferentes combinaciones de información.

Opciones habituales:

Value
Name
Value and name

Solo valor¶

Útil cuando el título del panel ya explica el significado.

Nombre y valor¶

Objetivos disponibles: 2

Útil cuando el panel se consulta fuera del contexto habitual.

Texto mediante mapa de valores¶

UP

Útil para representar estados.

Configurar el comportamiento ante ausencia de datos¶

Un panel Stat puede encontrarse en diferentes situaciones.

Valor cero¶

El valor real es 0.

Ejemplo:

sum(up)

Resultado:

Esto no significa necesariamente que no haya datos. Significa que la suma de los valores es cero.

Sin datos¶

La consulta no devuelve ninguna serie.

Ejemplo:

metrica_que_no_existe

Valor nulo¶

Existe una serie, pero el valor no está disponible en el punto consultado.

Error¶

La consulta, la fuente de datos o la conexión producen un error.

Importancia operativa¶

No se debe confundir:

con:

No data

Por ejemplo:

0 objetivos disponibles puede ser un resultado válido.
No data puede indicar un problema de consulta o conectividad.

Consultas para paneles Stat¶

Objetivos disponibles¶

sum(up)

Objetivos totales¶

count(up)

Objetivos caídos¶

count(up == 0)

Porcentaje de disponibilidad¶

100 * avg(up)

Objetivos de Node Exporter disponibles¶

sum(up{job="node_exporter"})

Estado de Node Exporter¶

up{job="node_exporter"}

Memoria disponible¶

node_memory_MemAvailable_bytes

Memoria utilizada en porcentaje¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Carga de un minuto¶

node_load1

Carga de cinco minutos¶

node_load5

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"
  }
)

Tráfico recibido¶

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

Ejemplo completo 1: objetivos disponibles¶

Objetivo¶

Crear un panel Stat que muestre cuántos objetivos están disponibles.

Consulta¶

sum(up)

Configuración¶

Título: Objetivos disponibles
Visualización: Stat
Unidad: None
Decimales: 0
Reducción: Last

Umbrales¶

Si se esperan dos objetivos:

0      Rojo
1      Amarillo
2      Verde

Descripción¶

Número de objetivos cuyo último scraping ha sido correcto.
El valor se obtiene sumando la métrica up.

Resultado esperado¶

Ejemplo completo 2: disponibilidad global¶

Objetivo¶

Mostrar la disponibilidad global como porcentaje.

Consulta¶

100 * avg(up)

Configuración¶

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

Umbrales¶

0      Rojo
90     Amarillo
99     Verde

Descripción¶

Porcentaje medio de objetivos disponibles en el último scraping.

Resultado esperado¶

100.0 %

si todos los objetivos están disponibles.

Ejemplo completo 3: uso de memoria¶

Objetivo¶

Mostrar el porcentaje actual de memoria utilizada.

Consulta¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Configuración¶

Título: Memoria utilizada
Visualización: Stat
Unidad: Percent (0-100)
Decimales: 1
Min: 0
Max: 100
Sparkline: Activada

Umbrales¶

0      Verde
70     Amarillo
90     Rojo

Descripción¶

Porcentaje de memoria utilizada por el sistema.
Los valores superiores al 90 % requieren una revisión del consumo de memoria.

Ejemplo completo 4: estado textual de Node Exporter¶

Objetivo¶

Mostrar UP o DOWN en lugar de 1 o 0.

Consulta¶

up{job="node_exporter"}

Configuración¶

Título: Estado de Node Exporter
Visualización: Stat

Mapa de valores¶

1 → UP
0 → DOWN

Colores¶

UP   → Verde
DOWN → Rojo

Descripción¶

Estado del último scraping realizado sobre Node Exporter.
UP indica que Prometheus ha podido consultar el endpoint de métricas.
DOWN indica que el último scraping ha fallado.

Ejemplo completo 5: carga del sistema¶

Objetivo¶

Mostrar la carga actual del sistema.

Consulta¶

node_load1

Configuración¶

Título: Carga del sistema
Visualización: Stat
Unidad: None
Decimales: 2
Sparkline: Activada

Descripción¶

Carga media del sistema durante el último minuto.
Este valor no es un porcentaje de CPU.

Consideración¶

La carga del sistema debe interpretarse teniendo en cuenta el número de CPU disponibles.

Consultar el número de CPU:

count(
  node_cpu_seconds_total{
    mode="idle"
  }
)

Esta consulta puede devolver una serie por CPU y por instancia. Para calcular el número de CPU por instancia:

count by (instance) (
  node_cpu_seconds_total{
    mode="idle"
  }
)

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

Objetivo¶

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

Pasos¶

Acceder a Grafana:

http://localhost:3000

Abrir un dashboard existente o crear uno nuevo.
Añadir un panel.
Seleccionar Prometheus.
Introducir:

sum(up)

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

Objetivos disponibles

Configurar la unidad como None.
Configurar los decimales a 0.
Guardar el panel.
Guardar el dashboard.

Actividades¶

Anota el valor mostrado.
Compáralo con la consulta:

up

Comprueba cuántas series devuelve up.
Explica por qué sum(up) devuelve un único valor.
Añade una descripción al panel.

Ejemplo de sesión 2: crear una disponibilidad porcentual¶

Objetivo¶

Crear un panel Stat que muestre la disponibilidad global.

Consulta¶

100 * avg(up)

Pasos¶

Añadir un panel nuevo.
Seleccionar Prometheus.
Introducir la consulta.
Seleccionar Stat.
Configurar:

Título: Disponibilidad global
Unidad: Percent (0-100)
Decimales: 1
Min: 0
Max: 100

Configurar umbrales:

0      Rojo
90     Amarillo
99     Verde

Activar la sparkline.
Guardar el panel.
Guardar el dashboard.

Actividades¶

Comprueba el valor actual.
Detén Node Exporter:

sudo systemctl stop node_exporter

Espera al siguiente scraping.
Observa el valor.
Inicia Node Exporter:

sudo systemctl start node_exporter

Comprueba la recuperación.
Explica cómo cambia el color.

Ejemplo de sesión 3: configurar un mapa de valores¶

Objetivo¶

Representar el estado de Node Exporter como UP o DOWN.

Consulta¶

up{job="node_exporter"}

Pasos¶

Crear un panel Stat.
Introducir la consulta.
Configurar el título:

Estado de Node Exporter

Crear el mapa:

1 → UP
0 → DOWN

Configurar colores:

UP   → Verde
DOWN → Rojo

Guardar el panel.

Actividades¶

Comprueba el estado inicial.
Detén Node Exporter.
Espera al siguiente scraping.
Comprueba que aparece DOWN.
Inicia Node Exporter.
Comprueba que vuelve a aparecer UP.
Documenta el tiempo aproximado de detección.

Ejemplo de sesión 4: añadir una sparkline¶

Objetivo¶

Mostrar el valor actual y una tendencia reciente.

Consulta¶

node_load1

Pasos¶

Crear un panel Stat.
Introducir la consulta.
Seleccionar la visualización Stat.
Configurar:

Título: Carga actual
Unidad: None
Decimales: 2
Sparkline: Activada

Guardar el panel.
Generar carga temporal:

yes > /dev/null &

Observar la sparkline.
Detener la carga:

pkill yes

Observar la recuperación.

Actividades¶

Describe la forma de la sparkline.
Indica si el valor aumenta o disminuye.
Explica qué información aporta la sparkline.
Explica qué información adicional ofrecería un Time series.

Ejemplo de sesión 5: comparar Stat y Gauge¶

Objetivo¶

Comparar dos formas de representar el mismo indicador.

Consulta¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Panel 1: Stat¶

Título: Memoria utilizada
Visualización: Stat
Unidad: Percent (0-100)
Decimales: 1

Panel 2: Gauge¶

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

Actividades¶

Crea ambos paneles.
Colócalos juntos.
Configura los mismos umbrales.
Compara la legibilidad.
Explica cuál elegirías para:
Un resumen ejecutivo.
Un dashboard operativo.
Un análisis de capacidad.
Justifica la respuesta.

Ejemplo de sesión 6: diagnosticar un Stat sin datos¶

Objetivo¶

Identificar la causa de un panel Stat vacío.

Consulta incorrecta¶

metrica_de_prueba_inexistente

Pasos¶

Crear un panel Stat.
Introducir la consulta incorrecta.
Observar el resultado.
Abrir el inspector del panel.
Revisar la consulta ejecutada.
Revisar la respuesta.
Sustituir la consulta por:

up

Comprobar que aparecen datos.
Guardar el panel corregido.

Actividades¶

Explicar la diferencia entre:

Valor 0
No data
Error

Comprobar también:

sum(up)

y:

count(up)

Documentar qué representa cada resultado.

Ejemplo de sesión 7: crear varios indicadores¶

Objetivo¶

Crear un bloque de indicadores resumidos.

Crear los siguientes paneles Stat:

Título	Consulta	Unidad
Objetivos disponibles	`sum(up)`	None
Disponibilidad global	`100 * avg(up)`	Percent
Memoria utilizada	Consulta de memoria	Percent
Carga del sistema	`node_load1`	None
Tráfico recibido	Consulta de red	bytes/sec

Distribución¶

+----------------------+----------------------+----------------------+
| Objetivos disponibles| Disponibilidad global| Memoria utilizada    |
+----------------------+----------------------+----------------------+
| Carga del sistema    | Tráfico recibido     | Estado Node Exporter |
+----------------------+----------------------+----------------------+

Actividades¶

Crea los paneles.
Configura los títulos.
Configura las unidades.
Configura los decimales.
Configura los umbrales.
Activa sparklines donde sea útil.
Ordena los indicadores.
Comprueba que todos muestran datos.
Guarda el dashboard.

Ejemplo de sesión 8: utilizar un Stat con una variable¶

Objetivo¶

Crear un panel que cambie según la instancia seleccionada.

Crear la variable¶

Crear una variable de dashboard llamada:

instance

Consulta de variable:

label_values(up, instance)

Según la versión y la configuración de Grafana, puede ser necesario utilizar una consulta compatible con el editor de variables.

Consulta del panel¶

100 * (
  1 -
  node_memory_MemAvailable_bytes{
    instance=~"$instance"
  }
  /
  node_memory_MemTotal_bytes{
    instance=~"$instance"
  }
)

Configuración¶

Título: Memoria utilizada - $instance
Visualización: Stat
Unidad: Percent (0-100)

Actividades¶

Crea la variable.
Comprueba las instancias disponibles.
Crea el panel.
Cambia de instancia.
Observa cómo cambia el valor.
Comprueba el comportamiento con All.
Documenta el uso de la variable.

Ejemplo de sesión 9: verificar el valor desde la API de Prometheus¶

Objetivo¶

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

Consultar objetivos disponibles¶

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

Consultar disponibilidad¶

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

Mostrar únicamente el valor¶

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode 'query=sum(up)' \
  | jq -r '.data.result[0].value[1]'

Actividades¶

Consulta el valor desde Grafana.
Consulta el valor desde la API.
Compara ambos resultados.
Explica posibles pequeñas diferencias temporales.
Documenta la comprobación.

Buenas prácticas¶

Utilizar una consulta que devuelva un resultado claro¶

Un panel Stat funciona mejor cuando la consulta devuelve un único valor.

Ejemplo:

sum(up)

Es más claro que mostrar directamente muchas series y depender de una reducción poco evidente.

Configurar la unidad¶

Nunca dejar ambiguo un porcentaje, una cantidad de memoria o una velocidad de red.

No ocultar problemas con valores antiguos¶

Si se utiliza Last not null, revisar qué ocurre cuando la fuente deja de enviar datos.

Un valor antiguo puede parecer actual si no se comunica correctamente su antigüedad.

Utilizar títulos operativos¶

El título debe permitir entender el panel sin abrirlo.

Utilizar umbrales coherentes¶

Aplicar una misma convención en todos los paneles del dashboard.

Activar sparklines con moderación¶

Las sparklines son útiles para añadir contexto, pero no deben sustituir a un análisis temporal detallado.

No mostrar demasiados Stat juntos¶

Un conjunto excesivo de indicadores puede saturar visualmente el dashboard.

Agrupar únicamente los indicadores más importantes.

Combinar Stat con otras visualizaciones¶

Una buena combinación puede ser:

Stat: valor actual
Time series: tendencia
Table: detalle por instancia

Problemas habituales¶

El Stat muestra `No data`¶

Comprobar:

up

Después:

node_load1

Revisar:

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

El Stat muestra cero¶

Determinar si el cero es válido.

Ejemplo:

sum(up)

Si todos los objetivos están caídos, el resultado puede ser:

Esto es diferente de una consulta sin resultados.

El Stat muestra un valor inesperado¶

Comprobar:

Reducción.
Agregación.
Unidad.
Decimales.
Filtros.
Rango temporal.
Variables.

El Stat muestra demasiados valores¶

La consulta puede devolver varias series.

Soluciones:

sum(up)

avg(up)

max(node_load1)

También se puede configurar una reducción, pero conviene comprender primero las series devueltas.

El color no cambia¶

Revisar:

Que los umbrales estén activados.
Que el modo de color utilice los umbrales.
Que los valores estén en la misma escala.
Que la consulta devuelva un porcentaje si los umbrales están definidos de 0 a 100.
Que el panel no utilice un mapa de valores que sobrescriba el comportamiento esperado.

La unidad aparece duplicada¶

Ejemplo:

85 % %

Comprobar que:

La consulta no añade texto manualmente.
La unidad está configurada una sola vez.
El mapa de valores no incluye el símbolo %.

La sparkline no aparece¶

Revisar:

Que la consulta devuelva datos temporales.
Que el rango temporal tenga muestras.
Que la sparkline esté activada.
Que el panel no esté configurado únicamente para una consulta instantánea.
Que el resultado no sea exclusivamente un valor calculado sin historial.

El Stat muestra datos antiguos¶

Revisar:

Timestamp de la última muestra.
Intervalo de scraping.
Estado del target.
Uso de Last not null.
Rango temporal.
Disponibilidad de la fuente de datos.

Evidencias de la práctica¶

Crear el directorio:

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

Guardar las consultas:

cat > ~/laboratorio-grafana/evidencias/panel-stat/consultas-promql.txt <<'EOF'
Objetivos disponibles:
sum(up)

Objetivos totales:
count(up)

Objetivos caídos:
count(up == 0)

Disponibilidad global:
100 * avg(up)

Estado de Node Exporter:
up{job="node_exporter"}

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

Carga del sistema:
node_load1

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

Guardar una consulta desde la API:

curl -sG \
  http://localhost:9090/api/v1/query \
  --data-urlencode 'query=sum(up)' \
  | jq \
  > ~/laboratorio-grafana/evidencias/panel-stat/resultado-sum-up.json

Guardar un informe:

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

Dashboard utilizado:

Paneles creados:

Consultas utilizadas:

Unidades configuradas:

Umbrales configurados:

Mapas de valores utilizados:

Sparklines configuradas:

Prueba de caída realizada:

Resultado de la recuperación:

Problemas encontrados:

Soluciones aplicadas:

Conclusiones:
EOF

Capturas recomendadas:

01-stat-objetivos-disponibles.png
02-stat-disponibilidad.png
03-stat-memoria.png
04-stat-estado-node-exporter.png
05-stat-con-sparkline.png
06-stat-sin-datos.png
07-stat-dashboard-final.png

Práctica integradora¶

Objetivo¶

Crear un conjunto de paneles Stat para resumir el estado de un servidor Linux.

Paneles obligatorios¶

Panel 1: objetivos disponibles¶

sum(up)

Configuración:

Título: Objetivos disponibles
Unidad: None
Decimales: 0

Panel 2: disponibilidad global¶

100 * avg(up)

Configuración:

Título: Disponibilidad global
Unidad: Percent (0-100)
Decimales: 1
Min: 0
Max: 100

Panel 3: uso de memoria¶

100 * (
  1 -
  node_memory_MemAvailable_bytes
  /
  node_memory_MemTotal_bytes
)

Configuración:

Título: Memoria utilizada
Unidad: Percent (0-100)
Decimales: 1
Min: 0
Max: 100

Panel 4: estado de Node Exporter¶

up{job="node_exporter"}

Configuración:

Título: Estado de Node Exporter
Mapa: 1 = UP, 0 = DOWN

Panel 5: carga del sistema¶

node_load1

Configuración:

Título: Carga actual del sistema
Unidad: None
Decimales: 2
Sparkline: Activada

Tareas¶

Crear los cinco paneles.
Configurar los títulos.
Configurar las unidades.
Configurar los decimales.
Configurar los umbrales.
Crear el mapa de valores de Node Exporter.
Activar una sparkline.
Organizar los paneles.
Detener Node Exporter.
Observar los cambios.
Iniciar Node Exporter.
Comprobar la recuperación.
Exportar el dashboard.
Guardar las evidencias.
Completar el informe.

Tabla de resultados¶

Comprobación	Resultado	Observaciones
Panel de objetivos creado
Panel de disponibilidad creado
Panel de memoria creado
Panel de Node Exporter creado
Panel de carga creado
Fuente de datos correcta
Unidad configurada
Decimales configurados
Umbrales configurados
Mapa de valores configurado
Sparkline configurada
Paneles organizados
Prueba de caída realizada
Recuperación comprobada
Dashboard exportado
Evidencias guardadas

Puntos clave¶

El panel Stat muestra principalmente un valor resumido.
Es adecuado para indicadores actuales y tarjetas de resumen.
Una consulta que devuelve un único valor suele ser más fácil de interpretar.
sum(up) muestra el número de objetivos disponibles.
100 * avg(up) muestra un porcentaje medio de disponibilidad.
La reducción determina qué valor se representa cuando existen varias muestras.
Last not null puede ser útil, pero puede ocultar la antigüedad del dato.
Las unidades deben corresponder al significado de la métrica.
Los decimales deben limitarse a la precisión necesaria.
Los umbrales permiten cambiar el color según el valor.
Los mapas de valores permiten mostrar textos como UP y DOWN.
Las sparklines aportan contexto temporal resumido.
Un Stat no sustituye a un panel Time series.
0, No data y Error son situaciones diferentes.
El panel debe probarse con datos disponibles y con objetivos caídos.
La consulta, la fuente de datos y el rango temporal deben revisarse ante un panel vacío.
Los paneles Stat funcionan bien como resumen superior de un dashboard.
La información detallada debe mostrarse mediante otras visualizaciones.
La documentación del panel facilita su mantenimiento.
Los cambios importantes deben guardarse y exportarse cuando sea necesario.

Preguntas de comprobación¶

¿Qué finalidad tiene un panel Stat?
¿Qué tipo de información representa mejor?
¿Qué diferencia existe entre un panel Stat y un Gauge?
¿Qué diferencia existe entre un panel Stat y un Time series?
¿Qué consulta utilizarías para contar los objetivos disponibles?
¿Qué consulta utilizarías para calcular la disponibilidad global?
¿Qué función cumple una reducción?
¿Qué diferencia existe entre Last y Last not null?
¿Qué unidad utilizarías para un porcentaje de memoria?
¿Qué unidad utilizarías para la memoria disponible en bytes?
¿Qué función cumplen los umbrales?
¿Qué es un mapa de valores?
¿Cómo representarías los valores 1 y 0 como UP y DOWN?
¿Qué utilidad tiene una sparkline?
¿Qué diferencia existe entre 0 y No data?
¿Qué revisarías si el panel Stat aparece vacío?
¿Qué problemas puede producir una consulta con varias series?
¿Cuándo utilizarías sum(up) en lugar de up?
¿Por qué no conviene utilizar demasiados decimales?
¿Qué elementos configurarías antes de guardar un panel Stat?
¿Qué comprobarías al detener Node Exporter?
¿Qué información incluirías en la descripción de un panel Stat?
¿Qué paneles combinarías con un Stat para aportar contexto?
¿Qué evidencias guardarías durante la práctica?
¿Qué características debe tener un buen indicador Stat?

Resultado esperado¶

Al finalizar esta sección, el alumno debe ser capaz de crear indicadores resumidos y configurarlos correctamente.

El proceso completo será:

Seleccionar una métrica
        |
        v
Crear una consulta PromQL
        |
        v
Reducir el resultado
        |
        v
Seleccionar Stat
        |
        v
Configurar unidad y decimales
        |
        v
Configurar umbrales
        |
        v
Añadir mapa de valores o sparkline
        |
        v
Probar datos normales y errores
        |
        v
Guardar y documentar

El resultado final debe ser un conjunto de paneles Stat claros, legibles y útiles para conocer rápidamente el estado actual de la plataforma monitorizada.