Egutierrez
59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
---
|
|
name: fleet_monitoring
|
|
description: "Monitorización de toda la flota de equipos (PCs locales, VPS y móviles Termux): un agente Go ligero por nodo empuja métricas de sistema a VictoriaMetrics y se visualizan en Grafana."
|
|
tags: [monitoring, fleet-metrics, grafana, victoriametrics, infra]
|
|
repo_url: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/dataforge/fleet_monitoring"
|
|
---
|
|
|
|
# fleet_monitoring
|
|
|
|
Sistema de monitorización tipo conky pero centralizado para todos los equipos del ecosistema.
|
|
|
|
## Arquitectura
|
|
|
|
```
|
|
nodo (lucas, magnus, datardos, layla, homer, …)
|
|
└─ metrics_agent (binario Go)
|
|
recolecta CPU/RAM/swap/disco/red/temp/procesos cada N s
|
|
└─ push HTTPS (basic auth)
|
|
▼
|
|
magnus (hub central, sin docker, todo systemd detrás de Caddy)
|
|
├─ VictoriaMetrics 127.0.0.1:8428 (TSDB, retención 12 meses)
|
|
│ ingesta pública: https://metrics-<hash>.organic-machine.com/api/v1/import/prometheus
|
|
└─ Grafana 127.0.0.1:3001 (dashboards)
|
|
https://grafana-<hash>.organic-machine.com
|
|
```
|
|
|
|
El agente es **push** (no pull): cada nodo empuja sus métricas al hub. Esto atraviesa NAT
|
|
(móvil Termux, LAN doméstica) sin necesidad de abrir puertos en cada nodo y escala a N equipos
|
|
sin tocar la config central — basta desplegar el agente con su `node` y el endpoint.
|
|
|
|
## Nodos
|
|
|
|
| node | qué es | acceso | estado |
|
|
|---|---|---|---|
|
|
| lucas | PC local (Linux nativo) | local | objetivo fase 1 |
|
|
| magnus | VPS organic-machine (hub) | `ssh om` | objetivo fase 1 |
|
|
| datardos | VPS | `ssh dd` | objetivo fase 1 |
|
|
| layla | móvil Android (Termux) | vía WireGuard/bastión | fase posterior (cross-build arm64) |
|
|
| homer | servidor (registrado en el VPS) | pendiente | fase posterior |
|
|
|
|
## Componentes
|
|
|
|
- **apps/metrics_agent/** — el agente Go que corre en cada nodo. Compone las funciones del
|
|
registry del grupo `fleet-metrics` (`collect_host_metrics`, `format_prom_exposition`,
|
|
`push_prom_remote`).
|
|
- **hub/** — infraestructura como código del hub central en magnus: units systemd
|
|
(VictoriaMetrics, Grafana), snippet de Caddy, provisioning de Grafana (datasource) y
|
|
dashboards JSON. Documenta cómo se montó el hub para poder reproducirlo.
|
|
|
|
## Secretos (en `pass`, nunca en el repo)
|
|
|
|
- `grafana/fleet-admin` — usuario `admin` de Grafana.
|
|
- `fleet/ingest-pass` — password del usuario `fleet` para el endpoint de ingesta (basic auth).
|
|
|
|
## Alertas
|
|
|
|
Se enviarán por **unibus** (NATS), el bus de mensajería del ecosistema, cuando esté listo.
|
|
Grafana alerting emitirá a unibus vía webhook. Fase posterior.
|