Documentation
Surveillance
Activer l'interrogation pour chaque VM, comprendre les métriques collectées, et voir la commande de sonde exacte.
La surveillance ici est sans agent : rien ne s’installe sur les serveurs, aucun port supplémentaire n’est ouvert. L’application maintient une connexion SSH par VM surveillée et exécute exactement une commande en lecture seule par cycle d’interrogation.
Activer pour une VM
Ouvrez l’onglet Surveillance de la VM, puis :
- Activez Activer.
- Choisissez l’identifiant à utiliser pour l’interrogation — devrait être un compte à faibles privilèges, voir Identifiants.
- Réglez l’intervalle (secondes). 60 secondes est un équilibre raisonnable pour la plupart des cas.
L’interrogation démarre en environ 15 secondes — une tâche de surveillance en arrière-plan vérifie périodiquement quelles VMs sont activées et les fait correspondre aux tâches en cours. Désactiver arrête la tâche dans le même délai.
Le bouton Sonder maintenant exécute un cycle immédiat sans attendre le prochain cycle programmé.
Coffre verrouillé signifie surveillance arrêtée
L’interrogation a besoin d’identifiants, et les identifiants résident dans le coffre. Donc :
- Verrouiller le coffre → toutes les tâches d’interrogation s’arrêtent.
- Déverrouiller le coffre → les tâches redémarrent automatiquement.
- Verrouiller l’écran → aucun effet, l’interrogation continue normalement.
Métriques collectées
| Groupe | Contenu |
|---|---|
| Charge système | Uptime, charge moyenne sur 1 minute, pourcentage CPU |
| Mémoire | RAM utilisée/totale, swap utilisé/total |
| Disque | Par point de montage : utilisé, total, pourcentage |
| Réseau | Débit de réception/émission en octets par seconde |
| Processus | Six plus gros consommateurs CPU |
| Sécurité | Ports en écoute, comptes, clés SSH autorisées, sudoers, journal de connexion |
Le pourcentage CPU et le débit réseau sont dérivés entre deux sondages consécutifs — donc le premier sondage après l’activation de la surveillance n’aura pas ces deux valeurs.
Historique et rétention
- Les échantillons bruts sont conservés 14 jours, puis nettoyés.
- Entre-temps, les données sont agrégées en résumés quotidiens et conservées à long terme. Les rapports mensuels lisent cette table de résumé, pas les échantillons bruts — s’ils lisaient les échantillons, un « rapport mensuel » n’inclurait silencieusement que deux semaines.
L’onglet de surveillance dessine les graphiques à partir de la fenêtre de 14 jours d’échantillons bruts.
Quand le serveur ne répond pas
Un sondage manqué est normal. Deux échecs consécutifs marquent la VM comme inaccessible et créent un événement.
Après chaque échec, l’intervalle de sondage recule progressivement (5 minutes maximum) pour éviter de marteler une machine morte. Quand elle récupère, l’intervalle revient à la normale et un événement de récupération est enregistré.
Commande de sonde
C’est ce dont vous aurez besoin quand le client demandera « qu’est-ce que votre logiciel exécute sur notre serveur ». La commande est une constante dans le code source, jamais assemblée à partir de données utilisateur, et l’application l’affiche verbatim (bouton Voir la commande de sonde dans l’onglet de surveillance).
LC_ALL=C; export LC_ALL
echo '@@VMOPS:uptime@@'; cat /proc/uptime
echo '@@VMOPS:load@@'; cat /proc/loadavg
echo '@@VMOPS:cpu@@'; grep '^cpu ' /proc/stat
echo '@@VMOPS:mem@@'; grep -E '^(MemTotal|MemFree|MemAvailable|Buffers|Cached|SwapTotal|SwapFree):' /proc/meminfo
echo '@@VMOPS:net@@'; cat /proc/net/dev
echo '@@VMOPS:disk@@'; df -P -k
echo '@@VMOPS:procs@@'; ps -eo pcpu,pmem,comm --sort=-pcpu | head -6
echo '@@VMOPS:ports@@'; ss -H -tuln || netstat -tuln
echo '@@VMOPS:users@@'; cut -d: -f1,3,7 /etc/passwd
echo '@@VMOPS:keys@@'; # readable authorized_keys file contents
echo '@@VMOPS:sudoers@@'; cat /etc/sudoers /etc/sudoers.d/*
echo '@@VMOPS:auth@@'; journalctl -u sshd # or /var/log/auth.log
echo '@@VMOPS:fail2ban@@'; fail2ban-client status sshd
echo '@@VMOPS:end@@'
Quatre principes derrière cette conception :
Un seul aller-retour. Chaque sondage est exactement un sh -c renvoyant un unique bloc
délimité. Surveiller 30 machines par minute ne doit pas signifier 300 canaux d’exécution.
Lire /proc, pas top. La sortie de top, vmstat et free change selon les distributions
et les locales ; /proc non.
Fixe et auditable. La commande n’est jamais assemblée à partir de données d’entrée — il n’y a aucune surface pour l’injection de commandes, et son contenu est toujours inspectable.
Se dégrader, jamais casser. Tout ce qui nécessite root et qui n’est pas disponible revient vide, et le reste du sondage aboutit quand même.