Čo je LAN agent a kedy ho použiť
V skratke: LAN agent je malý program, ktorý nainštalujete na ľubovoľný počítač vo vnútornej sieti klienta. Cez internet sa pripojí na ePulz.io, vypýta si zoznam adries, ktoré má kontrolovať, lokálne ich preverí a výsledky pošle späť. Vďaka tomu môžete sledovať aj zariadenia, ku ktorým sa cloudový monitoring nedostane (NAS, kamery, interné servery, lokálne webové aplikácie).
Kedy LAN agent potrebujete
- Sledovanie NAS a domácich či firemných serverov - Synology, QNAP, vlastný stroj so ZFS úložiskom
- IP kamery, prístupové systémy, alarmy v predajni alebo kancelárii
- Interné webové aplikácie - Grafana, Jira, GitLab, Bookstack za firewallom
- Sieťová infraštruktúra - router, switche, prístupové body (AP), VPN brána
- IoT zariadenia a brány - Modbus a MQTT brány a podobne
- MSP scenár - správa monitoringu pre viacero klientov s jednotným nasadením
Ako to funguje
- V dashboarde vytvoríte agenta a dostanete token (jedinečný kľúč)
epulzio_…- zobrazí sa iba raz. - Inštalačný príkaz spustíte na zariadení v sieti klienta (Raspberry Pi, mini PC, NAS, počítač s Dockerom).
- Agent sa každých 30 sekúnd opýta ePulz.io na nové úlohy a vykoná lokálne kontroly.
- Výsledky pošle naspäť cez HTTPS - rovnaké zabezpečené spojenie, ktoré používa každý prehliadač.
- Keď sa stav zariadenia zmení, ePulz.io spustí štandardné upozornenie (e-mail, Telegram, webhook).
Čo agent odosiela (a čo nikdy)
Agent posiela presne tri veci:
- Heartbeat - verzia agenta, hostname a názov operačného systému
- Výsledky kontrol, ktoré ste si sami nastavili - stav up/down, odozva v ms, prípadná chybová hláška
- Nič iné. Nikdy neskenuje sieť, nečíta súbory, nezbiera prevádzku ani údaje o zariadeniach. Každú jednu IP adresu, ktorej sa dotkne, definujete vy v dashboarde.
- Obmedzený token: token agenta umožňuje iba stiahnuť vlastný zoznam kontrol a odoslať výsledky. Nemá prístup k vášmu účtu, fakturácii ani iným monitorom a kedykoľvek ho v dashboarde zrušíte (Revoke).
- Beží bez práv roota: služba beží ako neprivilegovaný systémový používateľ so systemd sandboxom (NoNewPrivileges, ProtectSystem=strict). Root je potrebný len pri inštalácii.
- Plne auditovateľný: celý agent je jediný Python súbor (~600 riadkov, iba štandardná knižnica) - pred spustením si môžete prečítať každý riadok.
Tri typy LAN kontrol
| Typ | Cieľ | Čo zistí |
|---|---|---|
| lan_ping | 192.168.1.10 | Zariadenie odpovedá na ICMP (jednoduchý sieťový test). Najlacnejšia kontrola. |
| lan_tcp | 10.0.0.50:5432 | Konkrétny port je otvorený. Aj keď zariadenie beží, samotná služba (databáza, SSH a podobne) môže byť dole. |
| lan_http | http://nas.local | HTTP alebo HTTPS aplikácia odpovedá v poriadku (kódy 2xx/3xx). Vhodné pre rozhranie NAS alebo interný dashboard. |
Čo sa stane, keď agent prestane fungovať
ePulz.io každú minútu overuje, či agenti posielajú signál života (heartbeat). Ak sa agent neozve viac ako 5 minút, dostanete e-mail aj Telegram správu: "LAN agent X je offline". Keď sa agent vráti, dostanete potvrdenie o návrate online. Vďaka tomu sa vám nestane, že by ste mali falošný pocit, že všetko beží len preto, že agent prestal posielať dáta.
Začnite
V ďalšom kroku vám ukážeme inštaláciu agenta a vytvorenie prvého LAN monitora.