Що таке LAN agent і коли використовувати
Стисло: LAN-агент - це невелика програма, яку ви встановлюєте на будь-який комп'ютер у внутрішній мережі клієнта. Через інтернет він підключається до ePulz.io, запитує список адрес, які має перевіряти, локально їх перевіряє і надсилає результати назад. Завдяки цьому ви можете моніторити навіть пристрої, до яких хмарний моніторинг не дотягується (NAS, камери, внутрішні сервери, локальні веб-застосунки).
Коли потрібен LAN-агент
- Моніторинг NAS і домашніх або корпоративних серверів - Synology, QNAP, власна машина зі сховищем ZFS
- IP-камери, системи контролю доступу, сигналізації у магазині або офісі
- Внутрішні веб-застосунки - Grafana, Jira, GitLab, Bookstack за firewall
- Мережева інфраструктура - роутер, комутатори, точки доступу (AP), VPN-шлюз
- IoT-пристрої та шлюзи - шлюзи Modbus і MQTT та подібне
- MSP-сценарій - управління моніторингом для кількох клієнтів з єдиним розгортанням
Як це працює
- У dashboard ви створюєте агента та отримуєте token (унікальний ключ)
epulzio_…- він показується лише один раз. - Команду встановлення ви запускаєте на пристрої в мережі клієнта (Raspberry Pi, mini PC, NAS, комп'ютер з Docker).
- Кожні 30 секунд агент запитує в ePulz.io нові завдання та виконує локальні перевірки.
- Результати він надсилає назад через HTTPS - те ж саме захищене з'єднання, яке використовує кожен браузер.
- Коли стан пристрою змінюється, ePulz.io запускає стандартне сповіщення (e-mail, Telegram, webhook).
Що агент надсилає (і чого ніколи)
Агент надсилає рівно три речі:
- Heartbeat - версія агента, hostname і назва операційної системи
- Результати перевірок, які ви самі налаштували - статус up/down, час відповіді в ms і можливе повідомлення про помилку
- Більше нічого. Він ніколи не сканує мережу, не читає файли, не збирає трафік чи дані пристроїв. Кожну окрему IP-адресу, до якої він звертається, визначаєте ви самі в dashboard.
- Обмежений token: token агента дозволяє лише завантажити власний список перевірок і надіслати результати. Він не має доступу до вашого облікового запису, білінгу чи інших моніторів, і ви можете будь-коли відкликати його в dashboard (Revoke).
- Працює без прав root: служба працює від імені непривілейованого системного користувача із sandbox systemd (NoNewPrivileges, ProtectSystem=strict). Root потрібен лише під час встановлення.
- Повністю відкритий для аудиту: увесь агент - це один Python-файл (~600 рядків, лише стандартна бібліотека) - перед запуском ви можете прочитати кожен рядок.
Три типи LAN-перевірок
| Тип | Ціль | Що виявляє |
|---|---|---|
| lan_ping | 192.168.1.10 | Пристрій відповідає на ICMP (простий мережевий тест). Найдешевша перевірка. |
| lan_tcp | 10.0.0.50:5432 | Конкретний порт відкритий. Навіть якщо пристрій працює, сама служба (база даних, SSH і подібне) може бути недоступна. |
| lan_http | http://nas.local | HTTP- або HTTPS-застосунок відповідає коректно (коди 2xx/3xx). Підходить для інтерфейсу NAS або внутрішнього dashboard. |
Що станеться, коли агент перестане працювати
ePulz.io щохвилини перевіряє, чи агенти надсилають сигнал життя (heartbeat). Якщо агент не виходить на зв'язок понад 5 хвилин, ви отримаєте і e-mail, і повідомлення в Telegram: "LAN-агент X офлайн". Коли агент повернеться, ви отримаєте підтвердження про повернення онлайн. Завдяки цьому ви не матимете хибного відчуття, що все працює, лише тому, що агент перестав надсилати дані.
Розпочніть
У наступному кроці ми покажемо вам встановлення агента та створення першого LAN-монітора.