Qu'est-ce qu'un LAN agent
En bref : l'agent LAN est un petit programme que vous installez sur n'importe quel ordinateur du réseau interne du client. Via Internet, il se connecte à ePulz.io, demande la liste des adresses qu'il doit vérifier, les contrôle localement et renvoie les résultats. Grâce à cela, vous pouvez surveiller même les équipements auxquels la surveillance cloud n'a pas accès (NAS, caméras, serveurs internes, applications web locales).
Quand vous avez besoin d'un agent LAN
- Surveillance des NAS et des serveurs domestiques ou d'entreprise - Synology, QNAP, machine personnelle avec stockage ZFS
- Caméras IP, systèmes de contrôle d'accès, alarmes en magasin ou au bureau
- Applications web internes - Grafana, Jira, GitLab, Bookstack derrière un pare-feu
- Infrastructure réseau - routeur, switches, points d'accès (AP), passerelle VPN
- Équipements et passerelles IoT - passerelles Modbus et MQTT et similaires
- Scénario MSP - gestion de la surveillance pour plusieurs clients avec un déploiement unifié
Comment cela fonctionne
- Dans le tableau de bord, vous créez un agent et recevez un token (une clé unique)
epulzio_…- il n'est affiché qu'une seule fois. - Vous exécutez la commande d'installation sur un équipement du réseau client (Raspberry Pi, mini PC, NAS, ordinateur avec Docker).
- Toutes les 30 secondes, l'agent demande de nouvelles tâches à ePulz.io et effectue les vérifications locales.
- Il renvoie les résultats via HTTPS - la même connexion sécurisée qu'utilise n'importe quel navigateur.
- Lorsque l'état d'un équipement change, ePulz.io déclenche la notification standard (e-mail, Telegram, webhook).
Ce que l'agent envoie (et ce qu'il n'envoie jamais)
L'agent envoie exactement trois choses :
- Heartbeat - version de l'agent, hostname et nom du système d'exploitation
- Résultats des vérifications que vous avez configurées vous-même - statut up/down, temps de réponse en ms et message d'erreur le cas échéant
- Rien d'autre. Il ne scanne jamais le réseau, ne lit jamais de fichiers, ne collecte ni trafic ni données d'équipements. Chaque adresse IP qu'il touche est définie par vous dans le tableau de bord.
- Token limité : le token de l'agent permet uniquement de télécharger sa propre liste de vérifications et d'envoyer les résultats. Il n'a pas accès à votre compte, à la facturation ni aux autres moniteurs, et vous pouvez le révoquer à tout moment dans le tableau de bord (Revoke).
- Fonctionne sans privilèges root : le service tourne sous un utilisateur système non privilégié avec un sandbox systemd (NoNewPrivileges, ProtectSystem=strict). Root n'est nécessaire que pendant l'installation.
- Entièrement auditable : l'agent entier est un seul fichier Python (~600 lignes, bibliothèque standard uniquement) - avant de l'exécuter, vous pouvez lire chaque ligne.
Trois types de vérifications LAN
| Type | Cible | Ce qu'il détecte |
|---|---|---|
| lan_ping | 192.168.1.10 | L'équipement répond à ICMP (un simple test réseau). La vérification la moins coûteuse. |
| lan_tcp | 10.0.0.50:5432 | Un port spécifique est ouvert. Même si l'équipement fonctionne, le service lui-même (base de données, SSH et similaires) peut être en panne. |
| lan_http | http://nas.local | L'application HTTP ou HTTPS répond correctement (codes 2xx/3xx). Convient pour une interface NAS ou un tableau de bord interne. |
Que se passe-t-il quand un agent cesse de fonctionner
ePulz.io vérifie chaque minute si les agents envoient un signe de vie (heartbeat). Si un agent ne se manifeste plus pendant plus de 5 minutes, vous recevez un e-mail et un message Telegram : "L'agent LAN X est hors ligne". Lorsque l'agent revient, vous recevez une confirmation de retour en ligne. Grâce à cela, vous n'aurez pas le faux sentiment que tout fonctionne simplement parce que l'agent a cessé d'envoyer des données.
Commencez
À l'étape suivante, nous vous montrons l'installation de l'agent et la création du premier moniteur LAN.
Étape suivante :
Installation de l'agent LAN sur un équipement du réseau client.
Installer l'agent ->