spoke-monitoring
Módulo de monitorización y observabilidad para Spoke que integra Grafana, Prometheus, Loki, Telegraf, Dozzle y NUT-UPSD. Requiere hub de Spoke y redes Docker específicas.
Ficha actualizada 25 sept 2026, 19:31 · upstream 25 sept 2026, 19:29 · release sin release detectada
Qué es spoke-monitoring
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este módulo proporciona una suite completa de observabilidad para entornos Spoke, centralizando métricas, logs y visualización. Incluye componentes clave como Grafana para dashboards, Prometheus para recolección de métricas, Loki para agregación de logs en modo monolítico y Telegraf como agente de métricas en el host. Además, soporta monitoreo de UPS mediante NUT-UPSD y visualización de logs Docker con Dozzle.
La arquitectura depende del hub de Spoke ya desplegado, requiriendo servicios externos como Traefik y PostgreSQL para persistencia. El despliegue se gestiona mediante docker compose con builds automáticos para usuarios no root en Prometheus y Telegraf. Se configura vía modules.yml definiendo IPs y variables de entorno, integrando reglas de enrutamiento en Traefik del hub.
Los recursos recomendados son 2 núcleos CPU, 2 GB de RAM y 20 GB de disco. Es compatible con despliegue de un clic dentro de la estructura Spoke, aunque requiere configuración manual de secretos como contraseñas de Grafana y OAuth para Authentik.
- Visualización centralizada de métricas de infraestructura y aplicaciones en Grafana
- Agregación y búsqueda de logs distribuidos con Loki y Alloy
- Monitoreo de estado del hardware (UPS) mediante NUT-UPSD
- Inspección en tiempo real de logs de contenedores Docker con Dozzle
- Integración de observabilidad en arquitecturas Spoke existentes
- Integración nativa con el ecosistema Spoke (Traefik, PostgreSQL)
- Soporte para múltiples herramientas de observabilidad (Prometheus, Loki, Grafana) en un solo módulo
- Configuración simplificada mediante docker compose y builds automáticos
- Monitoreo extendido a hardware externo (UPS) vía NUT-UPSD
- Compatibilidad con autenticación OAuth para Authentik
- Dependencia estricta del hub de Spoke y redes Docker específicas (troxy, soxy, auxy)
- Requiere configuración manual de secretos sensibles (contraseñas, claves secretas)
- Loki opera en modo monolítico según la documentación proporcionada
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Clonar en /path/to/spoke/modules y ejecutar make deploy MODULE=monitoring. Configurar IPs en modules.yml y definir secretos (grafana_admin_password, grafana_secret_key, etc.) antes de desplegar. Requiere 2 núcleos CPU, 2 GB RAM y 20 GB disco mínimo.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.