# 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 les clés du catalogue via `syncPermissionCatalog`). - Le rôle `super_admin` passe aussi les garde-fous UI/API même si le JWT local est encore sans la nouvelle clé. - Vérifiée côté backend (`requirePermissions`) + UI (`PermissionGate` / Options). - Accès refusés : `logAccessDenied` ; consultations : `audit_logs` (`vps_monitor_*`). ### Vérifier sur le VPS (SQL) ```bash sudo docker compose exec -T backend node -e " const {query}=require('./dist/db/connection'); (async()=>{ console.log(await query(\"SELECT key FROM permissions WHERE key='admin.vps_monitor.view'\")); console.log(await query(\"SELECT r.name, COUNT(*)::int AS n FROM role_permissions rp JOIN roles r ON r.id=rp.role_id JOIN permissions p ON p.id=rp.permission_id WHERE p.key='admin.vps_monitor.view' GROUP BY r.name\")); process.exit(0); })().catch(e=>{console.error(e);process.exit(1);}); " ``` ## Démarrage (VPS) ```bash cd ~/projects_repository/games-project git pull sudo npm run monitoring:up # Recreate API so it joins monitoring-net (required once after this networking fix) sudo docker compose up -d --force-recreate backend sudo npm run phase-b:up:https curl -sS https://tloto.net/health ``` Vérifier la stack monitoring + connectivité backend → Prometheus : ```bash sudo docker compose --profile monitoring ps sudo docker compose logs --tail=40 prometheus sudo docker exec crypto_wallet_api node -e "fetch('http://prometheus:9090/-/healthy').then(r=>r.text()).then(console.log).catch(e=>{console.error(e);process.exit(1)})" sudo ss -tlnp | grep -E '9090|9100|8080' || echo "OK: ports monitoring non exposés" ``` Si `prediqo_prometheus` est en `Restarting`, regarder les logs (`permission denied` sur `/prometheus` = volume). Le service tourne en `user: root` pour écrire le volume ; sinon : ```bash sudo docker run --rm -v games-project_prometheus_data:/prometheus busybox chown -R 65534:65534 /prometheus sudo npm run monitoring:up ``` ## 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