WatchZit

Superviser des agences avec un collecteur distant

Comment surveiller le réseau d’une agence, d’un site client derrière un NAT ou d’un VLAN d’administration fermé depuis une seule console WatchZit — sans ouvrir le moindre port sur le site. Un guide pas à pas, du premier collecteur jusqu’aux cartes, aux alertes et à un collecteur de secours.

Ce que couvre ce guide

Une console WatchZit vérifie les appareils qu’elle peut joindre. Ceux d’une agence sont souvent hors de portée : ils sont derrière le NAT du routeur de l’agence, le VPN ne les couvre pas, ou le réseau d’administration est fermé volontairement. Le collecteur distant règle ce problème. C’est l’agent WatchZit ordinaire installé sur un ordinateur du site et marqué comme collecteur dans la console. Il reçoit les vérifications des appareils de son site, les exécute sur place, découvre le réseau du site et renvoie les résultats par sa propre connexion chiffrée. Quand la liaison avec la console tombe, il continue de mesurer, et un second collecteur peut prendre le relais si le premier tombe en panne.

Ce qu’il vous faut

  • Une console WatchZit en service (l’appliance ou le script d’installation ; voir la page de téléchargement).
  • Sur chaque site, un ordinateur toujours allumé : Linux ou Windows. Une petite VM ou une machine de la classe Raspberry Pi suffit ; l’agent Linux existe pour amd64 et arm64.
  • Depuis cet ordinateur, une connexion sortante vers le port des agents 8444 du serveur. Rien n’est à ouvrir sur le site : le collecteur se connecte vers l’extérieur, la console ne se connecte jamais à lui.
  • Des droits d’administrateur dans la console : seuls les administrateurs créent des collecteurs et choisissent d’où les appareils sont surveillés.

Préparer le serveur pour les agents externes

La console a deux ports : 8443 pour l’interface web et l’API, 8444 pour les agents. Réservez 8443 à vos réseaux d’administration et ne rendez joignable depuis les agences que le 8444, par exemple par une redirection de port sur le pare-feu du siège.

Si les agences joignent le serveur sous un autre nom que celui de la console, indiquez-le sous Paramètres → Réseau et accès comme Adresse publique des agents, par exemple https://monitor.example.com:8444. Elle figure dans chaque code d’inscription : définissez-la avant de créer des codes. Sur la même page, vous pouvez limiter les réseaux d’où les agents peuvent venir.

Installer l’agent sur le site

  1. Sous Agents, créez un code d’inscription : un nom, sa durée de validité en jours, le nombre d’ordinateurs qui peuvent l’utiliser et le groupe des nouveaux appareils. Le code n’est affiché qu’une fois. Il contient l’adresse du serveur et l’empreinte du certificat des agents, si bien que l’agent ne fait confiance qu’à votre serveur.
  2. Sur un ordinateur Windows, téléchargez le MSI depuis la page Agents et installez-le ; il demande le code. En silencieux : msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn. Le service s’appelle WatchZitAgent.
  3. Sous Linux, copiez la commande affichée par la page Agents : elle télécharge l’agent depuis le port des agents, vérifie son SHA-256 et l’installe avec le code comme service systemd watchzit-agent. Ou installez le paquet deb ou rpm de la version et lancez sudo watchzit-agent enroll --code "WZ1-…".

L’ordinateur apparaît comme un appareil avec son processeur, sa mémoire, ses disques et ses interfaces. S’il ne se connecte pas, vérifiez qu’il joint le port 8444 et les réseaux autorisés sous Paramètres → Réseau et accès ; le journal de l’agent se trouve dans C:\ProgramData\WatchZit Agent sous Windows et dans journalctl -u watchzit-agent sous Linux.

En faire un collecteur distant

Ouvrez la page de l’appareil du nouvel agent et cliquez sur Utiliser comme collecteur distant dans le cadre Agent. C’est tout côté collecteur : il n’a pas d’interface web propre et rien ne se configure localement — tout se règle dans la console.

La page Agents le liste désormais sous Collecteurs distants, avec son état et le nombre d’appareils qu’il surveille. Un collecteur se met à jour comme tout autre agent : un agent plus ancien que le serveur reçoit la version du serveur à sa connexion.

Attribuer les appareils du site

Chaque appareil a, sur sa page, le réglage Surveillé depuis : Cette console ou l’un de vos collecteurs distants. Pour un appareil, choisissez-y le collecteur et cliquez sur Enregistrer.

Pour de nombreux appareils à la fois, filtrez la liste des appareils (par exemple par le groupe de l’agence), cochez-les et utilisez Modifier la sélection : → Surveillé depuis.

Le collecteur reçoit alors leurs vérifications — ping, TCP, SNMP, pages web et scénarios, certificats, DNS, bases de données, MikroTik RouterOS, API JSON — avec les mots de passe et réglages SNMP nécessaires, les exécute à leurs intervalles et envoie les résultats à la console. Graphiques, déclencheurs et cartes fonctionnent exactement comme pour les appareils que la console vérifie elle-même.

Découvrir le réseau de l’agence

Inutile d’ajouter à la main les appareils de l’agence. Sous Appareils → Découverte, ajoutez une plage de l’agence (par exemple 192.168.20.0/24 ; jusqu’à un /22) et choisissez le collecteur à côté. Le collecteur analyse le réseau de son propre site : il envoie un ping à chaque adresse, essaie les ports courants, interroge SNMP avec vos profils SNMP et cherche les noms DNS. Lancez l’analyse tout de suite, chaque jour ou chaque semaine ; avec une planification, les nouveaux hôtes de l’agence apparaissent d’eux-mêmes.

Cochez les hôtes voulus et cliquez sur Ajouter comme équipements. Les appareils ajoutés depuis une plage analysée par un collecteur sont automatiquement surveillés depuis ce collecteur. La découverte SNMP sur la page d’un appareil et la lecture des informations, interfaces et VLAN passent aussi par le collecteur.

Une carte par site

Une carte par agence garde une vue claire. Sous Cartes, ajoutez une carte, cliquez sur Modifier et placez-y les appareils de l’agence avec Ajouter l'appareil. Liens suggérés propose les câbles que WatchZit a trouvés sur les appareils, avec les ports aux deux extrémités ; Tout ajouter les reprend, Organiser dispose la carte selon ses câbles et Enregistrer la conserve. Un plan d’étage peut servir d’image de fond.

Créez ensuite une carte d’ensemble avec une sous-carte par agence : une sous-carte mène à la carte de l’agence et affiche son pire état, de sorte qu’une agence en rouge saute aux yeux. Pour un écran mural, Paramètres → Affichages kiosque montre des cartes en plein écran derrière un lien secret.

Pour surveiller la liaison elle-même, ajoutez la vérification Chemin réseau (traceroute) à un appareil surveillé par le collecteur : le collecteur trace le chemin depuis son propre site, vous voyez donc chaque routeur sur le trajet depuis l’agence avec sa perte et sa latence, et quand la route a changé.

Alertes quand la liaison de l’agence ou le collecteur tombe

Quand la connexion entre l’agence et la console est coupée, le collecteur continue d’exécuter les vérifications. Les résultats — jusqu’à une journée, les 200 000 plus récents — attendent sur le collecteur et arrivent au retour de la connexion : les graphiques n’ont pas de trou.

Entre-temps, la console ne prétend pas en savoir plus qu’elle n’en sait : les vérifications des appareils du collecteur affichent Inconnu au lieu d’en panne, car le site va peut-être très bien. La vérification d’agent du collecteur lui-même ouvre un problème, et c’est le message que vous recevez : une alerte pour l’agence, pas une par appareil. La destination des problèmes se règle sous Paramètres → Notifications — e-mail, webhook, Slack, Microsoft Teams, Telegram, ntfy, PagerDuty, SMS et d’autres.

Dans l’agence, les dépendances limitent le bruit. Ouvrez la carte de l’agence et cliquez sur Dépendances : en suivant les câbles depuis le routeur, chaque appareil se voit proposer celui qui le précède. Cliquez sur Définir les dépendances cochées. Quand le routeur ou un commutateur de l’agence tombe, les appareils derrière sont seulement injoignables ; leurs problèmes sont enregistrés mais pas envoyés. Un déclencheur Aucune nouvelle donnée repère les vérifications qui ne livrent plus de valeurs.

Un second collecteur pour le basculement

Pour un site important, installez l’agent sur un second ordinateur du site et faites-en aussi un collecteur. Choisissez-le ensuite comme Secours à côté de Surveillé depuis sur la page de l’appareil, ou pour de nombreux appareils dans la liste sous Modifier la sélection : → Collecteur de secours.

Tant que le premier collecteur est hors ligne, le secours exécute les vérifications de ses appareils. Quand le premier revient, il les reprend. Pour rendre complètement les appareils à la console, cliquez sur Arrêter la collecte sur la page de l’appareil du collecteur.

Points à garder en tête

  • Les résultats gardés pendant une coupure ne survivent pas à un redémarrage du collecteur : après un redémarrage, il reçoit à nouveau ses vérifications de la console, et ce qu’il n’avait pas encore envoyé est perdu.
  • La mémoire tampon couvre jusqu’à une journée, au plus les 200 000 résultats les plus récents. Une coupure plus longue laisse un trou.
  • Les vérifications d’hyperviseurs restent à la console ; un collecteur ne les exécute pas.
  • Les vérifications Linux sans agent par SSH via un collecteur exigent que la clé d’hôte soit saisie dans la vérification : le collecteur ne peut pas l’enregistrer et affiche donc la clé qu’il a vue.
  • Pendant la coupure, la console montre les appareils du collecteur comme inconnus ; vous ne voyez leur état réel qu’à l’arrivée des résultats.
  • Supprimer l’agent sur la page de l’appareil rend sa clé inconnue ; pour réutiliser cet ordinateur, inscrivez-le avec un nouveau code.

Et ensuite

Questions et idées sont les bienvenues dans les GitHub Discussions. Les entreprises peuvent obtenir un support commercial de MaxZit (en anglais uniquement).