4.1 KiB
4.1 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 les clés du catalogue viasyncPermissionCatalog). - Le rôle
super_adminpasse 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)
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)
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 :
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 :
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
- 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