Cos'è LAN agent e quando usarlo
In breve: un agente LAN è un piccolo programma che installi su qualsiasi computer all'interno della rete interna del cliente. Tramite internet si collega a ePulz.io, richiede l'elenco degli indirizzi da controllare, li verifica localmente e invia i risultati indietro. Grazie a questo puoi monitorare anche dispositivi a cui il monitoring cloud non arriva (NAS, telecamere, server interni, applicazioni web locali).
Quando ti serve un agente LAN
- Monitoraggio di NAS e server domestici o aziendali - Synology, QNAP, macchina propria con storage ZFS
- Telecamere IP, sistemi di controllo accessi, allarmi in negozio o ufficio
- Applicazioni web interne - Grafana, Jira, GitLab, Bookstack dietro firewall
- Infrastruttura di rete - router, switch, access point (AP), gateway VPN
- Dispositivi IoT e gateway - gateway Modbus e MQTT e simili
- Scenario MSP - gestione del monitoraggio per più clienti con un deployment unificato
Come funziona
- Nella dashboard crei un agente e ricevi un token (una chiave univoca)
epulzio_…- viene mostrato una sola volta. - Esegui il comando di installazione su un dispositivo nella rete del cliente (Raspberry Pi, mini PC, NAS, computer con Docker).
- Ogni 30 secondi l'agente chiede a ePulz.io nuove attività ed esegue i controlli locali.
- Invia i risultati indietro via HTTPS - la stessa connessione sicura che usa qualsiasi browser.
- Quando lo stato di un dispositivo cambia, ePulz.io avvia la notifica standard (e-mail, Telegram, webhook).
Cosa invia l'agente (e cosa non invia mai)
L'agente invia esattamente tre cose:
- Heartbeat - versione dell'agente, hostname e nome del sistema operativo
- Risultati dei controlli che hai configurato tu stesso - stato up/down, tempo di risposta in ms ed eventuale messaggio di errore
- Nient'altro. Non scansiona mai la rete, non legge file, non raccoglie traffico né dati dei dispositivi. Ogni singolo indirizzo IP che tocca è definito da te nella dashboard.
- Token limitato: il token dell'agente permette solo di scaricare il proprio elenco di controlli e di inviare i risultati. Non ha accesso al tuo account, alla fatturazione o ad altri monitor, e puoi revocarlo nella dashboard in qualsiasi momento (Revoke).
- Funziona senza privilegi di root: il servizio gira come utente di sistema senza privilegi con un sandbox systemd (NoNewPrivileges, ProtectSystem=strict). Root serve solo durante l'installazione.
- Completamente verificabile: l'intero agente è un unico file Python (~600 righe, solo libreria standard) - prima di eseguirlo puoi leggere ogni riga.
Tre tipi di controlli LAN
| Tipo | Target | Cosa rileva |
|---|---|---|
| lan_ping | 192.168.1.10 | Il dispositivo risponde a ICMP (un semplice test di rete). Il controllo più economico. |
| lan_tcp | 10.0.0.50:5432 | Una porta specifica è aperta. Anche se il dispositivo è attivo, il servizio stesso (database, SSH e simili) potrebbe essere down. |
| lan_http | http://nas.local | L'applicazione HTTP o HTTPS risponde correttamente (codici 2xx/3xx). Adatto per un'interfaccia NAS o una dashboard interna. |
Cosa succede quando un agente smette di funzionare
ePulz.io ogni minuto controlla se gli agenti inviano un segnale di vita (heartbeat). Se un agente non si fa sentire per più di 5 minuti, ricevi sia una e-mail che un messaggio Telegram: "L'agente LAN X è offline". Quando l'agente torna, ricevi una conferma che è di nuovo online. In questo modo non rischi di avere la falsa sensazione che tutto funzioni solo perché l'agente ha smesso di inviare dati.
Inizia
Nel prossimo passo ti mostriamo l'installazione dell'agente e la creazione del primo monitor LAN.
Prossimo passo:
Installazione dell'agente LAN su un dispositivo nella rete del cliente.
Installa l'agente ->