games_app/docs/VPS-MONITORING.md
2026-11-01 17:50:25 +02:00

2.8 KiB
Raw Blame History

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.sock en 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

  1. Copier le dépôt + .env (sans secrets dans Git).
  2. docker compose --profile monitoring up -d puis stack Tloto habituelle.
  3. Volume prometheus_data = historique (optionnel à migrer).
  4. 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