Glouton:un agente de monitoreo de un solo binario que simplemente funciona.
Descubrimiento automático, TSDB integrada y un panel local centrado en el estado — listo para usar.
El agente que usamos en Bleemeo para hacer funcionar nuestro producto SaaS de monitoreo, publicado como open source. Probado en servidores Linux, Docker y Kubernetes.
Inicio rápido
La forma más rápida de ver Glouton en acción
Sin cuenta, sin registro.
docker run -d --name=glouton \
-v /var/lib/glouton:/var/lib/glouton \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /:/hostroot:ro \
-e GLOUTON_BLEEMEO_ENABLE=false \
--pid=host --net=host \
--cap-add SYS_PTRACE --cap-add SYS_ADMIN \
bleemeo/bleemeo-agentDespués abre http://localhost:8015. Con Bleemeo desactivado, la TSDB en disco arranca automáticamente, así que los rangos largos del panel (24 h, 7 d, 30 d) funcionan desde el primer momento.
Qué hace cada opción de Docker
| Opción | Por qué |
|---|---|
-v /var/lib/glouton:/var/lib/glouton | Conserva el archivo de estado, la TSDB y los datos de registro entre reinicios del contenedor. |
-v /var/run/docker.sock:/var/run/docker.sock | Detecta los contenedores que corren en el host y lee sus estadísticas. |
-v /:/hostroot:ro | Acceso de solo lectura al sistema de archivos del host (puntos de montaje, discos, línea de comandos del kernel, /proc/<pid> de los procesos del host). |
--pid=host | Ve los procesos del host, para el explorador de procesos y el descubrimiento por servicio. |
--net=host | Lee las métricas de red tal y como las ve el host, no las del espacio de nombres del contenedor. |
--cap-add SYS_PTRACE | Inspecciona el uso de memoria de los procesos y sus descriptores de archivo abiertos. |
--cap-add SYS_ADMIN | Lee la información de sistema de archivos y cgroup asociada a los espacios de nombres. |
Para una instalación endurecida (sin compartir el PID ni la red del host, montajes más restringidos), sigue la documentación de instalación.
En cada arranque, Glouton envía un único paquete anónimo: un identificador de instalación aleatorio, la versión y el formato de instalación de Glouton, el sistema operativo y la versión del kernel, la CPU y la memoria, y la zona horaria. Ningún valor de métrica, ningún nombre de servicio, ningún nombre de host, ninguna dirección IP. Para desactivarlo: GLOUTON_AGENT_TELEMETRY_ENABLE=false.
Panel local
Un panel en vivo en localhost:8015
Tarjetas KPI, la fila de servicios descubiertos y gráficos con color según el estado para sistema, red y E/S — con el historial de la TSDB integrada. Zoom arrastrando en cualquier gráfico, filtrado de sistemas de archivos y discos por dispositivo o punto de montaje, y el tema sigue al de tu sistema.
Qué hace
Un solo binario: recopilar, almacenar, mostrar
Glouton descubre automáticamente lo que se ejecuta en tu host o en tus contenedores, recopila las métricas y comprobaciones adecuadas, las almacena localmente y lo muestra todo en un panel y en una API compatible con Prometheus. Reenviarlo a otro sitio es opcional.
La cabecera de la TSDB representa aproximadamente la mitad de la memoria residente y se mantiene limitada por la cardinalidad de las métricas, no por la retención: guardar más historial en disco no cuesta RAM.
Recopilar
- Descubrimiento automático de los servicios en ejecución con conjuntos de métricas cuidados — más de 30 aplicaciones y protocolos (nginx, postgres, redis…).
- Runtimes de contenedores: Docker (incluido Docker Desktop en macOS, detectado automáticamente), containerd, Kubernetes.
- Métricas de aplicación: cualquier endpoint Prometheus, JMX para aplicaciones Java, StatsD para tus contadores y medidores.
- Métricas derivadas de logs: journald, syslog, auditd o logs de contenedores procesados por un pipeline de OpenTelemetry, del que se extraen contadores. Las líneas en sí no se almacenan ni se reenvían.
- Sondas y comprobaciones: HTTP/HTTPS, TCP, scripts al estilo Nagios, NRPE.
- Red y hardware: SNMP, SMART, IPMI, NVIDIA.
- Nativo en Kubernetes: métricas y comprobaciones por pod, guiadas por las etiquetas del propio clúster.
Almacenar
- TSDB integrada — el motor en disco de Prometheus, embebido. Retención de 15 días por defecto, configurable, sin procesos añadidos.
- Se activa automáticamente cuando Bleemeo está desactivado, así que el historial del panel funciona justo después del docker run.
- Endpoint Prometheus en /metrics para cualquier recolector externo.
- Consultas de rango en PromQL en /api/v1/query_range, con la misma forma de respuesta que un servidor Prometheus. Las consultas instantáneas y los endpoints de etiquetas no se sirven, así que una herramienta de dashboards sigue queriendo un Prometheus real delante.
Mostrar
- Panel local centrado en el estado: tarjetas KPI, servicios descubiertos y gráficos con zoom arrastrando.
- Página de detalle por contenedor, con sus propios gráficos históricos.
- Logs del agente en vivo dentro del panel, con búsqueda y color por severidad.
- Paquete de diagnóstico descargable desde la interfaz para los casos de soporte.
Instalación
Todos los destinos, un solo agente
El mismo binario y las mismas claves de configuración, sea cual sea la forma de despliegue.
Docker
El comando de inicio rápido de arriba. En el repositorio hay un Docker Compose con jmxtrans junto a Glouton.
Paquetes Linux
Paquetes .deb (Debian, Ubuntu) y .rpm (RHEL, CentOS, Fedora) construidos oficialmente. La guía está escrita para usuarios de Bleemeo, pero funciona igual de bien sin cuenta en cuanto pones bleemeo.enable: false.
Kubernetes
kubectl apply -f k8s.yaml desde la raíz del repositorio te da un DaemonSet por defecto y su RBAC. El chart de Helm y las opciones por clúster están en la documentación.
Windows
Un instalador MSI, construido desde packaging/windows/ en el repositorio y cubierto por la misma documentación de instalación.
macOS todavía no tiene instalador empaquetado: usa la imagen Docker publicada, o compila desde un clon (go run .). Los sockets de Docker Desktop y Colima se detectan automáticamente, así que tus contenedores aparecen sin configuración adicional.
Seguir siendo autónomo en una instalación por paquete
Los valores por defecto sirven para la mayoría de los casos. Prescindir del conector de Bleemeo son dos líneas: ponlas en /etc/glouton/conf.d/30-install.conf en una instalación por paquete, o pasa -e GLOUTON_BLEEMEO_ENABLE=false con la imagen Docker.
# /etc/glouton/conf.d/30-install.conf
bleemeo:
enable: falseEl otro ajuste que la gente busca es cuánto historial guarda la TSDB integrada:
agent:
local_store:
retention: 15dEn los paquetes de Linux, glouton-auto-upgrade.timer está activado por defecto y descarga paquetes nuevos del repositorio configurado. Si prefieres controlar tú las versiones, enmascáralo con systemctl disable --now glouton-auto-upgrade.timer. Con Docker: docker pull bleemeo/bleemeo-agent && docker restart glouton, o fija una etiqueta CalVer.
Documentación:InstalaciónReferencia de configuraciónServicios y métricas detectados
Alcance
Lo que Glouton no es
Mejor dejar claras las expectativas.
No es un recolector de logs
Glouton puede derivar métricas de los logs de aplicación, y muestra sus propios logs de ejecución en el panel para depurar, pero no almacena, indexa ni reenvía las líneas de log en sí. Para eso usa Vector, Fluent Bit o el collector de OpenTelemetry.
No es un agente de tracing ni APM
Sin spans, sin seguimiento de transacciones. Combínalo con un SDK de OpenTelemetry en tu aplicación si lo necesitas.
No sustituye a Prometheus por sí solo
Glouton sirve un endpoint compatible con Prometheus e incluye una TSDB adecuada para un único host, pero para un despliegue a escala de clúster seguirás queriendo un Prometheus real, un backend Mimir/Thanos, o Bleemeo Cloud.
Salidas
Tres formas de salir del agente
Todo aterriza primero en el disco local. Lo que pase después lo decides tú: los tres caminos son de primera clase.
Prometheus y Grafana
Recoge /metrics con tu propio Prometheus y luego apunta Grafana — o Dashglass, nuestra propia aplicación de dashboards de un solo binario — a ese Prometheus. En examples/prometheus hay una stack de Compose lista para usar.
MQTT y SquirrelDB
Publica en el broker que tú controles en v1/agent/<fqdn>/data, como JSON comprimido con zlib, y combínalo con SquirrelDB Ingestor para un almacenamiento Prometheus de larga duración autoalojado.
Bleemeo Cloud
Reenvía a nuestro SaaS para retención larga, alertas, notificaciones y paneles de toda la cuenta en todos tus agentes.
Preguntas que nos hacen sobre Glouton
Usarlo por su cuenta, y cómo se sitúa respecto a las herramientas que ya tienes.
¿Se puede usar Glouton sin cuenta de Bleemeo?
Sí, y es el punto de partida de esta página. Pon bleemeo.enable: false (o GLOUTON_BLEEMEO_ENABLE=false con Docker) y el agente funciona completamente solo: descubre servicios, recopila métricas, guarda 15 días de historial en su TSDB integrada y sirve tanto el panel local como el endpoint Prometheus. Ningún valor de métrica sale del host; la única llamada saliente que queda es el paquete anónimo de arranque descrito en el inicio rápido, y también se puede desactivar.
¿Glouton es realmente open source?
Licencia Apache 2.0, en GitHub, y es el mismo agente que operamos para la flota de Bleemeo Cloud, no una edición comunitaria recortada. El conector de Bleemeo es una salida opcional entre varias, no la razón de ser del binario.
¿Glouton necesita conexión a internet?
No. El panel, la TSDB y el endpoint Prometheus son locales al host. Solo hay tráfico saliente si activas una salida —el conector de Bleemeo o un broker MQTT— o si dejas activada la telemetría anónima.
¿En qué se diferencia de node_exporter o Telegraf?
Incluye ambos: node_exporter aporta las métricas del host y las entradas de Telegraf la recogida por servicio, como bibliotecas dentro de un único binario. Lo que Glouton añade encima es la capa de descubrimiento que decide qué recopilar y comprobar, la TSDB integrada y el panel: un solo proceso que instalar en lugar de un exporter por servicio más un Prometheus para guardar el resultado.
¿Puede guardar más de 15 días de historial en local?
Sí, agent.local_store.retention es configurable. La cabecera de la TSDB se mantiene limitada por la cardinalidad de las métricas y no por la retención, así que un historial más largo cuesta espacio en disco, no RAM.
¿Qué plataformas están soportadas?
Linux con los paquetes oficiales .deb y .rpm, Windows con un instalador MSI, Kubernetes como DaemonSet o con el chart de Helm, y Docker en cualquier sitio. macOS todavía no tiene instalador empaquetado: usa la imagen Docker o compila desde el código; los sockets de Docker Desktop y Colima se detectan automáticamente en ambos casos.
Construido sobre herramientas que ya conoces
Glouton incluye varios proyectos open source como bibliotecas: Prometheus para el motor de TSDB, PromQL y el modelo de datos, node_exporter para las métricas del host, Telegraf para las entradas por servicio, el Blackbox exporter para las sondas HTTP/TCP/DNS y la caducidad de certificados, el collector de OpenTelemetry para el pipeline de logs, y gopsutil para la inspección multiplataforma de procesos y del host.