2.8 KiB
2.8 KiB
Surveillance VPS (back-office Tloto)
Lecture seule des ressources hôte + conteneurs Docker, affichée dans Options → Surveillance VPS.
Architecture
Navigateur (HTTPS) → vps-gateway → backend Tloto
↓ PROMETHEUS_URL (réseau Docker)
prometheus (pas de port public)
↓ monitoring-net (internal)
node-exporter cadvisor
- Aucun port publié pour Prometheus, Node Exporter, cAdvisor.
- Le backend n’exécute aucune commande shell/Docker et ne monte pas
/var/run/docker.sock. - Exception documentée : cAdvisor monte
docker.socken lecture seule uniquement pour les métriques conteneurs. - L’API n’accepte pas de PromQL libre : métriques allowlistées (
cpu,mem,disk,net_in,net_out,load1).
Permission
- Clé :
admin.vps_monitor.view - Accordée par défaut au rôle
admin(sync catalogue) et àsuper_admin(toutes permissions). - Vérifiée côté backend (
requirePermissions) + UI (PermissionGate/ Options). - Accès refusés :
logAccessDenied; consultations :audit_logs(vps_monitor_*).
Démarrage (VPS)
cd ~/projects_repository/games-project
git pull
sudo npm run monitoring:up # profile monitoring
sudo npm run phase-b:up:https # rebuild backend + web
curl -sS https://tloto.net/health
Vérifier qu’aucun port monitoring n’est public :
sudo docker compose --profile monitoring ps
sudo ss -tlnp | grep -E '9090|9100|8080' || echo "OK: ports monitoring non exposés"
Variables d’environnement
| Variable | Défaut | Rôle |
|---|---|---|
PROMETHEUS_URL |
http://prometheus:9090 |
URL interne vue du backend |
MONITORING_RETENTION |
15d |
Rétention TSDB Prometheus |
VPS_MONITOR_TIMEOUT_MS |
8000 |
Timeout appels Prometheus |
VPS_MONITOR_*_WARN/CRITICAL |
voir .env.example |
Seuils d’affichage (lecture seule) |
Rate limiting
Les routes /api/v1/admin/vps-monitor/* utilisent vpsMonitorLimiter (30 req/min) en plus du limiteur API global.
Migration vers un autre VPS
- Copier le dépôt +
.env(sans secrets dans Git). docker compose --profile monitoring up -dpuis stack Tloto habituelle.- Volume
prometheus_data= historique (optionnel à migrer). - Ne jamais publier 9090/9100/8080 sur l’hôte.
Mise à jour des images
Versions épinglées dans docker-compose.yml (prom/prometheus:v2.55.1, prom/node-exporter:v1.8.2, gcr.io/cadvisor/cadvisor:v0.49.1). Après bump : sudo npm run monitoring:up puis tests santé scrape dans la page admin.
Hors scope (v1)
- Grafana public
- Restart / exec / SSH depuis le back-office
- Édition des seuils depuis l’UI