Cos'è LAN agent e quando usarlo

4 min di lettura · Agenti LAN (rete interna)

In breve: il LAN agent è un piccolo programma che installi su una macchina qualsiasi nella rete interna del cliente. Da Internet chiama ePulz.io, riceve l'elenco degli IP da controllare, li pinga localmente e invia i risultati indietro. In questo modo monitori anche i dispositivi a cui il monitoring cloud non arriva (NAS, telecamere, server interni, applicazioni web locali).

Quando ti serve il LAN agent

Monitoring di NAS e server domestici/aziendali - Synology, QNAP, macchina propria con ZFS
Telecamere IP, sistemi di accesso, allarmi in negozio o ufficio
Applicazioni web interne - Grafana, Jira, GitLab, Bookstack dietro firewall
Infrastruttura di rete - router, switch, AP, VPN gateway
Dispositivi IoT e gateway - Modbus gateways, MQTT broker
Scenario MSP - gestione del monitoring per più clienti con un deployment standardizzato

Come funziona

Nella dashboard crei un agente e ricevi un token plzag_... (mostrato una sola volta).
Esegui il comando di installazione sulla macchina nella rete del cliente (Raspberry Pi, mini PC, NAS, Docker host).
L'agente ogni 30 secondi chiede a ePulz.io le attività e esegue i check locali.
Invia i risultati indietro via HTTPS - la stessa connessione che usa qualsiasi browser.
Al cambio di stato del dispositivo ePulz.io avvia la notifica standard (email, Telegram, webhook).

Nota di sicurezza importante: tutta la comunicazione esce solo verso l'esterno dalla tua rete (HTTPS outbound sulla porta 443). Non ti serve mai port forwarding sul router, IP pubblico statico o tunnel VPN. Per la sicurezza IT dell'azienda cliente è tipicamente accettabile come aprire Gmail.

Tre tipi di check LAN

Tipo	Target	Cosa rileva
lan_ping	192.168.1.10	Il dispositivo risponde a ICMP. Il check più economico.
lan_tcp	10.0.0.50:5432	Una porta specifica è aperta. Anche se l'host è up, il servizio (DB, SSH, ...) potrebbe essere down.
lan_http	http://nas.local	L'applicazione HTTP/HTTPS restituisce 2xx/3xx. NAS GUI, dashboard interna.

Cosa succede quando l'agente si spegne

ePulz.io ogni minuto controlla che gli agenti inviino l'heartbeat. Se un agente non risponde per più di 5 minuti, ricevi un messaggio sia email che Telegram: "Il LAN agent X è offline". Quando l'agente torna ricevi una notifica di back-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 mostriamo l'installazione dell'agente e la creazione del primo monitor LAN.

Prossimo passo:

Installazione del LAN agent su una macchina nella rete del cliente.

Installazione dell'agente