[[./accueil| ↩ Retour à l'accueil du projet]]
====== 10) Script : Supervision & Statut ======

Ce document définit la structure logique et les indicateurs mesurés par le script de supervision. Appelé depuis le [[./04_menu_principal|Menu Principal]], ce module offre une lecture immédiate et centralisée de la santé du VPS et de l'état du réseau privé.

===== 1. Indicateurs de Santé de l'Hôte (VPS) =====

Le script interroge le système Debian ou Fedora pour extraire les constantes matérielles clés :
  * **Charge CPU :** Pourcentage global d'utilisation des processeurs.
  * **Mémoire RAM :** Quantité de mémoire vive consommée et espace restant disponible au Mo près.
  * **Espace Disque :** Taux d'occupation des partitions de stockage pour anticiper toute saturation.
  * **État des Services Maîtres :** Vérification du statut d'exécution des démons principaux (''nftables'', ''nginx'', ''postfix'', ''wg-quick@wg0'').

===== 2. Suivi de l'Activité Réseau & Conteneurs =====

En plus des ressources physiques, le script dresse la carte d'activité de l'infrastructure virtuelle :
  * **Statut des Instances :** Liste l'intégralité des VM conteneurs déclarées dans la base de données et indique si elles sont actuellement allumées ou éteintes.
  * **Activité des Tunnels VPN :** Interroge l'interface WireGuard pour l'ensemble des clients. Affiche la date et l'heure du dernier échange réseau (*Latest Handshake*) et le volume de données transférées pour chaque utilisateur.

===== 3. Ergonomie d'Affichage & Journalisation =====

  * **Codes Couleur :** Pour faciliter la lecture rapide de l'administrateur, les indicateurs sains apparaissent en vert, les valeurs proches des limites en jaune (ex: disque à plus de 80%), et les pannes critiques en rouge (ex: service arrêté ou conteneur inaccessible).
  * **Sortie Écran Exclusive :** Ce script est un outil de consultation directe. Il rafraîchit l'écran à la demande de l'administrateur mais ne génère aucune écriture automatique dans le fichier de log global pour ne pas surcharger utilement ''/var/log/vps-gateway.log'' lors des simples consultations de routine.
  * **Journalisation des anomalies :** Seules les pannes réelles détectées par le script (ex: service maître effondré) déclenchent l'écriture d'une alerte horodatée dans les logs.

===== 4. Accès aux Ressources Techniques =====

Pour consulter le code source de ce script ou télécharger l'archive globale du projet :
➔ [[./12_telechargements_sources|🛠️ Aller au module 12) Téléchargements du projet et sources des scripts]]

[[./accueil| ↩ Retour à l'accueil du projet]]
