Co je LAN agent a kdy ho použít
Ve zkratce: LAN agent je malý program, který nainstalujete na libovolný počítač ve vnitřní síti klienta. Přes internet se připojí na ePulz.io, vyžádá si seznam adres, které má kontrolovat, lokálně je prověří a výsledky pošle zpět. Díky tomu můžete sledovat i zařízení, ke kterým se cloudový monitoring nedostane (NAS, kamery, interní servery, lokální webové aplikace).
Kdy LAN agent potřebujete
- Sledování NAS a domácích či firemních serverů - Synology, QNAP, vlastní stroj s úložištěm ZFS
- IP kamery, přístupové systémy, alarmy v prodejně nebo kanceláři
- Interní webové aplikace - Grafana, Jira, GitLab, Bookstack za firewallem
- Síťová infrastruktura - router, switche, přístupové body (AP), VPN brána
- IoT zařízení a brány - Modbus a MQTT brány a podobně
- MSP scénář - správa monitoringu pro více klientů s jednotným nasazením
Jak to funguje
- V dashboardu vytvoříte agenta a dostanete token (jedinečný klíč)
epulzio_…- zobrazí se pouze jednou. - Instalační příkaz spustíte na zařízení v síti klienta (Raspberry Pi, mini PC, NAS, počítač s Dockerem).
- Agent se každých 30 sekund zeptá ePulz.io na nové úlohy a provede lokální kontroly.
- Výsledky pošle zpět přes HTTPS - stejné zabezpečené spojení, které používá každý prohlížeč.
- Když se stav zařízení změní, ePulz.io spustí standardní upozornění (e-mail, Telegram, webhook).
Co agent odesílá (a co nikdy)
Agent odesílá přesně tři věci:
- Heartbeat - verzi agenta, hostname a název operačního systému
- Výsledky kontrol, které jste si sami nastavili - stav up/down, dobu odezvy v ms a případnou chybovou zprávu
- Nic jiného. Nikdy neskenuje síť, nečte soubory, nesbírá data o provozu ani o zařízeních. Každou jednotlivou IP adresu, na kterou sahá, definujete vy v dashboardu.
- Omezený token: token agenta umožňuje pouze stáhnout vlastní seznam kontrol a odeslat výsledky. Nemá přístup k vašemu účtu, fakturaci ani jiným monitorům a kdykoli ho můžete v dashboardu odvolat (Revoke).
- Běží bez práv roota: služba běží jako neprivilegovaný systémový uživatel se sandboxem systemd (NoNewPrivileges, ProtectSystem=strict). Root je potřeba jen při instalaci.
- Plně auditovatelný: celý agent je jediný soubor v Pythonu (~600 řádků, pouze standardní knihovna) - před spuštěním si můžete přečíst každý řádek.
Tři typy LAN kontrol
| Typ | Cíl | Co zjistí |
|---|---|---|
| lan_ping | 192.168.1.10 | Zařízení odpovídá na ICMP (jednoduchý síťový test). Nejlevnější kontrola. |
| lan_tcp | 10.0.0.50:5432 | Konkrétní port je otevřený. I když zařízení běží, samotná služba (databáze, SSH a podobně) může být dole. |
| lan_http | http://nas.local | HTTP nebo HTTPS aplikace odpovídá v pořádku (kódy 2xx/3xx). Vhodné pro rozhraní NAS nebo interní dashboard. |
Co se stane, když agent přestane fungovat
ePulz.io každou minutu ověřuje, jestli agenti posílají signál života (heartbeat). Pokud se agent neozve déle než 5 minut, dostanete e-mail i Telegram zprávu: "LAN agent X je offline". Když se agent vrátí, dostanete potvrzení o návratu online. Díky tomu se vám nestane, že byste měli falešný pocit, že vše běží jen proto, že agent přestal posílat data.
Začněte
V dalším kroku vám ukážeme instalaci agenta a vytvoření prvního LAN monitoru.