Avancé40 minPrérequis : Modules 2–4

Architecture multi-serveurs

Déployer plusieurs agents, découverte automatique, Vue Flotte.

Déployer l'agent sur plusieurs machines

Xytherion est conçu pour superviser un parc complet depuis un seul dashboard. Chaque machine a son propre agent indépendant — il n'y a aucun serveur central, aucune configuration partagée.

Pour chaque machine à surveiller, répétez l'installation :

bash
# Sur chaque serveur à surveillercurl -fsSL https://raw.githubusercontent.com/OpenDojoSystems0/xytherion-core/main/install.sh | bash # L'agent démarre sur le port 9001 par défaut# Si plusieurs agents sur la même machine : choisir des ports différentsxytherion --port 9002

La Topology Map — découverte automatique

La vraie magie : les agents s'annoncent mutuellement par UDP broadcast sur le port 9002 toutes les 8 secondes. Dès qu'un agent démarre sur votre réseau local, il apparaît automatiquement dans l'onglet Réseau.

Xytherion Dashboard — Topology Map
TOPOLOGY MAP — 3 agents détectésweb-01192.168.1.10db-01192.168.1.20api-01192.168.1.30redis192.168.1.40
i
La découverte automatique fonctionne uniquement au sein du même sous-réseau. Des agents sur des VLANs différents ne se découvrent pas, mais vous pouvez les ajouter manuellement dans le dashboard en entrant leur IP.

Vue Flotte — superviser tout d'un coup d'œil

La Vue Flotte affiche tous vos serveurs en une grille compacte : statut en ligne/hors ligne, CPU, RAM, et alertes actives. En cas d'incident, vous savez immédiatement quelle machine est touchée.

bash
# Ajouter manuellement un serveur dans un autre VLAN# Dans le dashboard : entrez l'IP directementhttp://10.0.1.50:9001    # serveur dans un autre sous-réseauhttp://vpn-server:9001   # via VPN

Architecture réseau recommandée

Port 9001 (HTTP/SSE)Restreindre à votre réseau local ou VPN — jamais exposé à Internet.
Port 9002 (UDP)Broadcast local uniquement — non routable, aucun risque d'exposition.
Dashboard (même port 9001)Servi par l'agent lui-même : mêmes règles que l'API. Activez XYTHERION_TOKEN si d'autres personnes accèdent à votre réseau.
✎

Exercice pratique — Infrastructure multi-serveurs

  1. 1Installez l'agent sur au moins 2 machines de votre réseau local.
  2. 2Ouvrez le dashboard — les agents doivent s'auto-découvrir dans l'onglet Réseau.
  3. 3Utilisez la Vue Flotte pour voir l'état de toutes les machines d'un coup.
  4. 4Éteignez l'une des machines — observez le Dead Man's Switch dans le dashboard.
  5. 5Redémarrez-la et vérifiez qu'elle réapparaît automatiquement dans la Topology Map.

Ce que vous venez d'apprendre

  • Chaque machine a son propre agent indépendant — pas de serveur central.
  • La découverte UDP broadcast est automatique au sein du même sous-réseau.
  • Des agents sur d'autres VLANs/réseaux s'ajoutent manuellement par IP.
  • La Vue Flotte donne une vue agrégée de toute l'infrastructure en un coup d'œil.