Grafana: conecta métricas y crea un panel útil
Grafana permite visualizar información de fuentes como Prometheus. Instalarlo es solo una parte: el panel debe consultar datos reales y explicar qué significan. Importar un dashboard no garantiza que coincida con tus exporters o etiquetas.
Este ejemplo utiliza Docker para una instalación local. Mantiene datos en un volumen y restringe el puerto a tu computadora.
Prepara credenciales y persistencia
mkdir -p grafana-lab/secrets
cd grafana-lab
umask 077
openssl rand -base64 32 > secrets/admin.txt
printf 'secrets/\n' > .gitignore
docker volume create grafana_lab_dataProtege la contraseña y consulta la versión mantenida que usarás en la documentación oficial. No reutilices una clave de ejemplo ni publiques el panel antes de completar su administración.
Ejecuta una imagen mantenida elegida conscientemente
Puedes configurar la imagen mediante una variable obligatoria para no presentar una etiqueta temporal como recomendación permanente:
export GRAFANA_IMAGE='grafana/grafana:VERSION_COMPATIBLE'Sustituye VERSION_COMPATIBLE por una versión mantenida que hayas seleccionado. Después:
docker run -d --name grafana-lab \
-p 127.0.0.1:3000:3000 \
--mount type=bind,src="$PWD/secrets",dst=/run/secrets,readonly \
-e GF_SECURITY_ADMIN_PASSWORD__FILE=/run/secrets/admin.txt \
-v grafana_lab_data:/var/lib/grafana \
"$GRAFANA_IMAGE"
docker logs --tail 50 grafana-labLa sintaxis __FILE está documentada para opciones de configuración compatibles. Revisa permisos del archivo si el contenedor no puede leerlo; no lo hagas público como solución.
Conecta Prometheus desde la red correcta
Añade una fuente Prometheus con una URL alcanzable desde Grafana. Si ambos están en contenedores, localhost dentro de Grafana no apunta al otro contenedor.
Utiliza una red compartida y el nombre del servicio, por ejemplo http://prometheus:9090 cuando corresponda a tu proyecto. La URL que abre tu navegador no siempre es la que debe utilizar el proceso de Grafana.
Construye un panel pequeño
Empieza por una consulta conocida, como up, y selecciona un rango temporal en que existan muestras. Define título y unidad según el significado de la consulta.
Para contadores, revisa si necesitas una tasa. Para porcentajes, define el denominador. Una línea que sube no permite concluir saturación si no entiendes qué está contando.
Importar dashboards sin perder contexto
Comprueba fuente, exporter y versión para los que se creó el dashboard. Si faltan métricas o etiquetas, adapta las consultas en lugar de cambiar el sistema para imitar una captura.
Un panel sin datos puede deberse a rango temporal, fuente equivocada, filtros o recopilación fallida. Revisa esas capas de forma separada.
Alertas y mantenimiento
Una alerta necesita condición, evaluación, destinatario y una acción útil. Prueba también que la notificación llegue y que se recupere después de resolver el problema.
Respalda configuración y base de Grafana según tu despliegue. No confundas ese respaldo con el de Prometheus: son sistemas y datos distintos.
Antes de exponer la interfaz, configura autenticación, TLS y permisos. Evita compartir la cuenta administrativa para la consulta habitual.
Preguntas frecuentes
¿Grafana almacena todas las métricas de Prometheus?
No en el diseño habitual descrito. Grafana consulta la fuente; debes mantener y respaldar cada componente según su función.
¿Por qué mi dashboard importado no muestra datos?
Puede esperar métricas, etiquetas o fuentes diferentes. Comprueba consultas, rango y recopilación antes de asumir que la instalación falló.
¿Una alerta creada ya está operativa?
No hasta comprobar evaluación, ruta de notificación y recepción. Prueba una condición controlada y documenta cómo debe responder quien la recibe.
En pocas palabras
Grafana representa datos de fuentes configuradas; no crea automáticamente las métricas que faltan. Un panel útil necesita consulta, unidad, etiquetas y rango temporal coherentes.
Conclusión
Guarda la configuración y prueba el panel con una situación conocida. Documenta qué mide y qué no, y revisa credenciales y acceso antes de compartirlo.
Para continuar, revisa Docker: qué es y cómo usarlo para ejecutar contenedores y Cómo instalar Docker en Ubuntu 24.04: guía práctica paso a paso.