Grafana — Dashboards de visualización¶

El panel de control central donde se monitoriza el estado del sistema y de la finca en tiempo real. Métricas, logs, estado de salud y datos de sensores en un solo sitio.

Como usuario¶

Qué podrás hacer¶

Ver el estado de los servicios (semáforos verde/amarillo/rojo)
Consultar datos de sensores de la finca (humedad, temperatura, peso de colmenas)
Ver el consumo energético (solar, baterías)
Explorar dashboards de biodiversidad (detecciones BirdNET, fauna con Frigate)
Ver tendencias a largo plazo

Cómo se accederá¶

Plataforma	Cómo
Navegador	`https://grafana.sc`
Ubuntu	Navegador
Android	Navegador — la interfaz es responsive
FireTV	No aplica

Primeros pasos (previstos)¶

Abrir https://grafana.sc
Inicia sesión con tu usuario SmallCountry
Cada perfil ve dashboards distintos: el biólogo ve datos de finca, el admin ve el estado del sistema, la familia ve el consumo energético.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Victoria Metrics	Fuente de métricas — consultas PromQL (lenguaje de consulta de métricas)
Victoria Logs	Fuente de logs — consultas LogQL (lenguaje de consulta de logs)
Prometheus	Scraper de métricas de todos los servicios
Uptime Kuma	Estado de salud de los servicios
Node-RED	Datos de sensores MQTT (protocolo de mensajería ligera para IoT) de la finca
n8n	Resúmenes diarios generados desde métricas
ollama-qdrant	Consultas de IA cruzando métricas

Servicios que lo hacen posible¶

Docker — contenedor grafana/grafana:latest

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	114
IP	10.10.10.114
Tier	A
Impacto	🔴 Crítico — sin Grafana el sistema está ciego

Almacenamiento persistente¶


ZFS (sistema de archivos con integridad de datos) dataset	`rpool/datos/grafana`
Montaje en LXC	`/opt/grafana/`
Subdirectorios	`config/` `data/` `logs/`
Backup	PBS (sistema de copias de seguridad de Proxmox) diario + dashboards versionados en Forgejo como JSON (formato de intercambio de datos)

Healthcheck¶

curl -s https://grafana.sc/api/health

Logs y diagnóstico¶

docker logs --tail 100 grafana

Backup manual¶

zfs snapshot rpool/datos/grafana@manual-$(date +%Y%m%d)

Problemas comunes¶

"Dashboard no carga datos": verificar que Victoria Metrics y Loki están corriendo
"Gráfica vacía": comprobar que el datasource está configurado correctamente en Grafana

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy[Caddy LXC 102] -->|TLS + forward_auth| Grafana[Grafana LXC 114]
    Authentik[Authentik LXC 105] -->|OAuth2| Grafana
    Grafana -->|consultas PromQL| VictoriaMetrics[Victoria Metrics]
    Grafana -->|consultas LogQL| VictoriaLogs[Victoria Logs]
    Grafana -->|API de estado| UptimeKuma[Uptime Kuma]
    Prometheus[Prometheus] -->|recolecta métricas| Servicios[Servicios monitorizados]
    NodeRED[Node-RED] -->|MQTT| Prometheus

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr1	3000	Caddy (LXC 102)

En Pi-hole¶

grafana.sc  →  10.10.10.114

En Caddy¶

grafana.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.10.114:3000
}

En Authentik¶


Provider	OAuth2
Grupos asignados	admin / finca

Orquestación¶

Componente	Path
Rol Ansible	`roles/grafana/`
Playbook	`deploy-grafana.yml`
Módulo OpenTofu	`modules/grafana/`
Semaphore	Proyecto `grafana`, Template `deploy`
Forgejo Actions	`.forgejo/workflows/grafana.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/programas/grafana.md`

Captura de pantalla¶

📸 Pendiente de captura desde la instancia en producción. Sustituye esta imagen por una captura real de https://grafana.sc.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Sitio oficial · Documentación · GitHub