Wat is LAN agent en wanneer
Kort gezegd: een LAN agent is een klein programma dat u op een willekeurige computer binnen het interne netwerk van de klant installeert. Via internet maakt hij verbinding met ePulz.io, vraagt de lijst met adressen op die hij moet controleren, controleert ze lokaal en stuurt de resultaten terug. Hierdoor kunt u ook apparaten monitoren die voor cloud monitoring niet bereikbaar zijn (NAS, camera's, interne servers, lokale webapplicaties).
Wanneer u een LAN agent nodig heeft
- Monitoring van NAS en thuis- of bedrijfsservers - Synology, QNAP, eigen machine met ZFS-opslag
- IP camera's, toegangscontrolesystemen, alarmen in een winkel of kantoor
- Interne webapplicaties - Grafana, Jira, GitLab, Bookstack achter een firewall
- Netwerkinfrastructuur - router, switches, access points (AP), VPN gateway
- IoT apparaten en gateways - Modbus- en MQTT-gateways en dergelijke
- MSP scenario - beheer van monitoring voor meerdere klanten met een uniforme uitrol
Hoe het werkt
- In het dashboard maakt u een agent aan en ontvangt u een token (een unieke sleutel)
epulzio_…- dit wordt slechts eenmaal getoond. - Het installatiecommando voert u uit op een apparaat in het netwerk van de klant (Raspberry Pi, mini PC, NAS, computer met Docker).
- Elke 30 seconden vraagt de agent ePulz.io om nieuwe taken en voert de lokale checks uit.
- De resultaten stuurt hij terug via HTTPS - dezelfde beveiligde verbinding die elke browser gebruikt.
- Wanneer de status van een apparaat verandert, start ePulz.io de standaard melding (e-mail, Telegram, webhook).
Wat de agent verstuurt (en wat nooit)
De agent verstuurt precies drie dingen:
- Heartbeat - agentversie, hostname en naam van het besturingssysteem
- Resultaten van de checks die u zelf heeft ingesteld - up/down status, responstijd in ms en een eventuele foutmelding
- Niets anders. Hij scant nooit het netwerk, leest geen bestanden en verzamelt geen verkeer of apparaatgegevens. Elk afzonderlijk IP-adres dat hij benadert, definieert u in het dashboard.
- Beperkt token: het agent token staat alleen toe om de eigen checklijst te downloaden en resultaten te versturen. Het heeft geen toegang tot uw account, facturatie of andere monitors, en u kunt het op elk moment in het dashboard intrekken (Revoke).
- Draait zonder root-rechten: de service draait als een systeemgebruiker zonder privileges met een systemd sandbox (NoNewPrivileges, ProtectSystem=strict). Root is alleen nodig tijdens de installatie.
- Volledig auditeerbaar: de hele agent is één enkel Python-bestand (~600 regels, alleen standaardbibliotheek) - voor het uitvoeren kunt u elke regel lezen.
Drie types LAN checks
| Type | Doel | Wat het detecteert |
|---|---|---|
| lan_ping | 192.168.1.10 | Het apparaat reageert op ICMP (een eenvoudige netwerktest). De goedkoopste check. |
| lan_tcp | 10.0.0.50:5432 | Een specifieke poort is open. Zelfs als het apparaat draait, kan de service zelf (database, SSH en dergelijke) plat liggen. |
| lan_http | http://nas.local | De HTTP- of HTTPS-applicatie reageert correct (2xx/3xx codes). Geschikt voor een NAS-interface of een intern dashboard. |
Wat gebeurt er als een agent uitvalt
ePulz.io controleert elke minuut of de agents een levensteken (heartbeat) sturen. Als een agent zich langer dan 5 minuten niet meldt, ontvangt u zowel een e-mail als een Telegram bericht: "LAN agent X is offline". Wanneer de agent terugkomt, ontvangt u een bevestiging dat hij weer online is. Hierdoor krijgt u niet ten onrechte de indruk dat alles draait, alleen omdat een agent geen data meer stuurt.
Begin
In de volgende stap laten we u de installatie van de agent en het aanmaken van de eerste LAN monitor zien.
Volgende stap:
Installatie van de LAN agent op een apparaat in het netwerk van de klant.
Agent installeren ->