Ce que couvre ce guide
WatchZit est un système de supervision gratuit et open source (AGPLv3) pour les réseaux et les serveurs, avec une console web sur votre propre serveur. Il n’y a ni clé de licence ni prix par hôte ou par contrôle ; MaxZit vend un support optionnel. Ce guide ne compare pas les produits. Il couvre le travail d’une équipe qui surveille des serveurs et des services, et dit, pour chaque partie, ce que fait WatchZit et où il s’arrête. La découverte, les modèles et les seuils appris sont traités dans le guide sur l’alternative à Zabbix ; le déploiement sous Windows et la connexion par annuaire dans le guide sur l’alternative à PRTG.
- Installation et premier hôte
- Des contrôles choisis dans une liste
- Serveurs : agent ou SSH et WinRM
- Applications web, certificats et API
- Vos propres déclencheurs
- Notifications, escalade et astreinte
- Acquittement, dépendances et maintenance
- Maintenance et acquittements depuis vos scripts
- Tableaux de bord, rapports et qui peut modifier quoi
- Ce que WatchZit ne fait pas
- Faire tourner WatchZit à côté de votre supervision actuelle
- Et ensuite
Installation et premier hôte
Importez l’appliance depuis la page de téléchargement (OVA, qcow2, VHDX ou ISO ; 2 processeurs, 2 Go de mémoire, disque de 16 Go), ou lancez le script d’installation sur un serveur 64 bits sous Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ :
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
Ouvrez https://<serveur>:8443, saisissez le jeton de configuration, créez le premier administrateur et configurez la connexion à deux facteurs. Ajoutez ensuite un hôte sous Appareils → Ajouter un appareil : un nom, une adresse IP ou un nom d’hôte, son type et son groupe, et Ping activé. Chaque port TCP que vous y saisissez devient un contrôle qui se connecte chaque minute. Dépend de indique le routeur ou le commutateur par lequel l’hôte est joint.
C’est toute la configuration : aucun fichier à modifier et aucun rechargement. Chaque modification est écrite dans le Journal d’audit, avec son auteur.
Des contrôles choisis dans une liste
Sur la page de l’appareil, Ajouter une vérification propose ces types. Chacun a son propre Intervalle (secondes) (de 10 à 3 600 ; 60 par défaut) et son Délai (ms) ; les mots de passe et jetons des contrôles sont stockés chiffrés et ne sont plus jamais affichés.
| Contrôle | Mesure |
|---|---|
| Ping (ICMP), Port TCP | temps de réponse et perte de paquets ; si un port accepte les connexions, et à quelle vitesse |
| Page web (HTTP) | code d’état, temps de réponse, un texte qui doit figurer sur la page, jours avant l’expiration du certificat |
| Certificat TLS | jours avant son expiration et s’il est approuvé, sur n’importe quel port TLS, avec un nom de serveur pour SNI |
| DNS | un serveur DNS doit répondre pour un nom avec un type d’enregistrement et, en option, une valeur attendue |
| PostgreSQL, MySQL / MariaDB | authentification avec un utilisateur de supervision, version, connexions, temps de réponse |
| Scénario web (plusieurs étapes) | une connexion et les pages qui suivent, étape par étape, comme un utilisateur |
| Valeur d'une API JSON | un nombre tiré de n’importe quelle API JSON |
| Linux par SSH (sans agent), Windows par WinRM (sans agent) | CPU, mémoire, swap ou fichier d’échange, le disque le plus plein et l’uptime |
| Chemin réseau (traceroute) | chaque routeur sur le chemin avec perte et latence, comme MTR |
| Hyperviseur (vSphere, Proxmox VE) | hôtes, machines virtuelles et banques de données |
| SNMP | interfaces, CPU, stockage et n’importe quel OID numérique |
Pour les mêmes contrôles sur de nombreux hôtes, un modèle les ajoute à tous les appareils d’un type ou d’un groupe, y compris aux appareils ajoutés plus tard ; sous Modifier la sélection : dans la liste des appareils, vous réglez le groupe, la dépendance ou un modèle pour de nombreux hôtes à la fois.
Serveurs : agent ou SSH et WinRM
L’agent WatchZit pour Windows (MSI) et Linux (deb, rpm ; x86-64 et arm64) ouvre une seule connexion sortante vers le port 8444 ; les serveurs n’ont donc besoin d’aucun port ouvert. Il s’inscrit avec un code à usage unique de la page Agents et se met à jour lui-même depuis la console. Chaque minute, il remonte le CPU, la mémoire, chaque disque et chaque interface, ainsi que :
- Surveiller des services sur la page de l’appareil : un service qui s’arrête ouvre un problème.
- Surveiller des processus : des noms de programmes comme
nginx,sqlservr.exeoujava, avec combien tournent, leur CPU et leur mémoire ; si aucun ne tourne, un problème s’ouvre. - Les événements critiques et d’erreur des journaux Windows System et Application, et les messages de priorité err et plus graves du journal systemd, dans Journaux.
- Les conteneurs Docker sous Linux et les machines Hyper-V sous Windows, toutes les cinq minutes.
Là où rien ne doit être installé, Linux par SSH (sans agent) exécute une seule commande fixe qui ne lit que /proc, df et uname, et vérifie la clé d’hôte à chaque exécution ; Windows par WinRM (sans agent) s’authentifie en NTLMv2 avec des messages chiffrés, ou passe par HTTPS. Leurs valeurs portent les mêmes noms que celles de l’agent, donc les mêmes déclencheurs s’appliquent. Le guide Superviser des serveurs Linux et Windows sans agent, par SSH et WinRM montre la configuration.
Applications web, certificats et API
- Page web (HTTP) contrôle une URL : son code d’état, un texte sur la page et les jours avant l’expiration de son certificat.
- Scénario web (plusieurs étapes) parcourt une application comme le ferait un utilisateur. Une étape par ligne — la méthode et l’adresse, le code d’état attendu, un texte que la page doit contenir et les données du formulaire ; les cookies sont conservés d’une étape à l’autre, et
{secret}est le mot de passe du contrôle :
Il mesure la durée de toutes les étapes et combien ont réussi ; l’alerte nomme l’étape qui a échoué.GET /login | 200 | Sign in POST /login | 302 | | user=monitor&password={secret} GET /dashboard | | Welcome - Certificat TLS surveille la messagerie, LDAP ou tout autre port TLS. Les déclencheurs intégrés Le certificat expire bientôt (moins de 21 jours) et Le certificat expire (moins de 7) s’y appliquent.
- Valeur d'une API JSON lit un nombre dans un point de terminaison de santé ou d’état de vos propres services : une adresse, un chemin comme
results.cpu.0.current, et en option une authentification Bearer ou basique.
Vos propres déclencheurs
Des déclencheurs intégrés surveillent déjà les appareils en panne, les contrôles en panne, la charge CPU élevée, la mémoire et les disques pleins, la perte de paquets et les certificats qui expirent. Les vôtres se créent sous Problèmes → Déclencheurs :
- Valeur hors limites : une valeur (charge CPU, temps de réponse, connexions …) au-dessus ou en dessous d’un seuil, pendant au moins quelques minutes, pour qu’un bref écart n’ouvre pas de problème ; avec une Gravité et S'applique à tous les appareils, un groupe ou un seul appareil.
- Un seul contrôle : le bouton cloche à côté d’un contrôle sur la page de l’appareil ajoute un déclencheur pour ce seul contrôle, par exemple un disque important ou le temps de réponse d’une page web.
- Aucune nouvelle donnée : un contrôle qui n’a reçu aucune nouvelle valeur pendant le nombre de minutes choisi — un agent qui ne se signale plus.
- Message syslog ou trap : un texte ou une expression régulière dans les messages syslog, les traps ou les journaux système des agents.
Un problème se ferme de lui-même quand la condition prend fin. Les déclencheurs qui apprennent ce qui est normal et les prévisions sont expliqués dans le guide sur l’alternative à Zabbix.
Notifications, escalade et astreinte
Sous Paramètres → Notifications, les administrateurs ajoutent des canaux : e-mail par votre serveur SMTP, un webhook JSON (signé en HMAC-SHA256 dans X-WatchZit-Signature si vous définissez une clé), Slack, Microsoft Teams, Discord, Telegram, ntfy, PagerDuty (les problèmes ouvrent et résolvent des incidents) et SMS par Twilio ou votre propre passerelle. Chaque canal a une gravité minimale et, avec Aussi à la résolution, signale aussi quand les problèmes sont résolus.
Sous Escalade et heures d'astreinte d’un canal :
- Prévenir après (minutes) : le canal n’est informé que des problèmes encore ouverts après ce délai — le chef d’équipe après 15 minutes quand la première ligne n’a pas réagi.
- Répéter toutes les (minutes) : prévient de nouveau tant que le problème reste ouvert. Les problèmes acquittés ne sont ni escaladés ni répétés, sauf si Aussi les problèmes acquittés est activé.
- Seulement certains jours et heures (astreinte) : par exemple des SMS à l’équipe de nuit du lundi au vendredi de 18 h à 08 h et tout le week-end. Un problème qui commence en dehors de ces heures arrive au canal quand son astreinte commence, s’il est encore ouvert.
- Une rotation, c’est un canal par personne ou par équipe, chacun avec ses propres jours et heures.
Un canal qui a été prévenu d’un problème est aussi prévenu de sa résolution ; les autres non.
Acquittement, dépendances et maintenance
- Problèmes liste ce qui est ouvert, le plus grave en premier. Prendre en charge un problème avec une note indique aux autres que quelqu’un s’en occupe. Les problèmes résolus restent un an dans l’historique.
- Dépendances : avec Dépend de réglé, un hôte derrière un routeur en panne est seulement injoignable ; ses problèmes sont enregistrés mais pas envoyés.
- Maintenance sous Problèmes → Maintenance pour des appareils ou des groupes : ils restent mesurés, mais rien n’est envoyé ; les problèmes encore ouverts à la fin de la fenêtre sont alors envoyés. Répétition fait revenir la fenêtre chaque jour, chaque semaine ou chaque mois, en option jusqu’à un dernier jour. Les rapports de disponibilité montrent le temps de maintenance à part.
Maintenance et acquittements depuis vos scripts
Créez un jeton sous Mon compte → Jetons d'API ; il agit avec votre rôle et n’est affiché qu’une fois. Un script de déploiement peut alors planifier une fenêtre de maintenance avant de redémarrer les serveurs :
curl -H "Authorization: Bearer wzat_…" -H "Content-Type: application/json" \
-d '{"name":"Deploy","starts_at":"2026-11-20T22:00:00+01:00","ends_at":"2026-11-20T22:30:00+01:00","group_ids":[3]}' \
https://monitor.example.com:8443/api/v1/maintenance
L’API lit aussi l’état, les appareils, les contrôles, les graphiques et les problèmes, et acquitte les problèmes avec POST /api/v1/problems/{id}/ack. Les modifications faites avec un jeton sont écrites dans le journal d’audit avec le nom du jeton.
Tableaux de bord, rapports et qui peut modifier quoi
- Tableaux de bord avec graphiques, valeurs actuelles, états des appareils, problèmes ouverts, cartes et graphiques issus de sources de données ; ils se rechargent chaque minute pour un écran mural.
- Rapports : la disponibilité par appareil sur 7, 30 ou 90 jours ou un mois, avec les temps d’arrêt et le nombre de problèmes, en CSV ou PDF, avec un Objectif SLA (%) par groupe et par e-mail chaque semaine ou chaque mois.
- Rôles : Administrateur, Opérateur (appareils, contrôles, cartes, déclencheurs, maintenance, tableaux de bord) et Lecteur. Connexion avec deux facteurs, Active Directory / LDAP ou authentification unique (OpenID Connect, SAML 2.0).
Ce que WatchZit ne fait pas
- Pas de fichiers de configuration ni d’import. Hôtes, contrôles et déclencheurs se configurent dans la console ; les configurations existantes ne peuvent pas être importées, et l’historique commence le jour où vous ajoutez un hôte.
- Pas de contrôle qui exécute vos propres scripts ou plugins. Vos propres valeurs viennent d’un contrôle Valeur d'une API JSON sur un de vos services, d’un OID SNMP ou d’une source de données sur un graphique.
- Pas de résultats envoyés de l’extérieur. L’API lit les données, acquitte les problèmes et planifie la maintenance ; elle ne crée ni hôtes, ni contrôles, ni déclencheurs.
- Les contrôles sans agent couvrent l’essentiel (CPU, mémoire, swap ou fichier d’échange, disque le plus plein, uptime). Chaque disque, les services, processus et journaux demandent l’agent.
- Les contrôles de bases de données sont PostgreSQL et MySQL/MariaDB ; un scénario web compte de 1 à 10 étapes.
- Le serveur tourne sous Linux (x86-64) avec PostgreSQL, ou en appliance.
Faire tourner WatchZit à côté de votre supervision actuelle
- Installez WatchZit sur sa propre VM ; rien ne change sur le serveur de supervision existant.
- Commencez par un groupe d’hôtes. Utilisez les contrôles sans agent ou installez l’agent WatchZit à côté de ce qui tourne aujourd’hui sur les serveurs ; l’agent n’a besoin que de sa connexion sortante vers le port 8444.
- Donnez à WatchZit ses propres utilisateurs de supervision (SSH, WinRM, bases de données, scénarios web), pour distinguer ses connexions et les supprimer plus tard.
- Envoyez d’abord les problèmes de WatchZit vers un canal de test, pas vers les téléphones d’astreinte.
- Comparez pendant quelques semaines quels problèmes chaque système a signalés et lesquels comptaient, puis décidez lequel alerte l’équipe d’astreinte.
Et ensuite
- Tout ce que fait WatchZit est sur la page des fonctionnalités ; il se télécharge sur la page de téléchargement.
- Les équipements réseau en SNMP : Une alternative à LibreNMS et Observium.
- Les agences derrière un NAT : Superviser des agences avec un collecteur distant.
- La référence complète est le guide utilisateur intégré à la console ; voir la documentation.
Les questions et idées sont les bienvenues dans les GitHub Discussions. Les entreprises peuvent obtenir un support commercial de MaxZit (en anglais uniquement).
Nagios et Checkmk sont des marques de leurs propriétaires respectifs. MaxZit n’est ni affilié aux propriétaires de Nagios ou de Checkmk, ni sponsorisé ou recommandé par eux ; les noms ne sont utilisés que pour décrire le sujet de ce guide.