Guida e tutorialAgenti LAN (rete interna) › Crea primo monitor LAN

Crea primo monitor LAN

4 min di lettura · Agenti LAN (rete interna)

In breve: dopo l'installazione dell'agente crei un monitor LAN tramite il pulsante "Aggiungi nuovo monitor". Nel dropdown del tipo selezioni lan_ping, lan_tcp o lan_http, inserisci il target e selezioni un agente dall'elenco.

Passo per passo

  1. Nella dashboard clicca su + Aggiungi nuovo monitor.
  2. Inserisci un nome (ad es. "NAS Synology - backup" oppure "Stampante reception").
  3. Nel campo Tipo di monitor seleziona uno dei tipi LAN - vedi la tabella sotto.
  4. Nel campo URL/hostname/host:port inserisci il target.
  5. Nel campo LAN agent seleziona l'agente che deve eseguire il controllo.
  6. Imposta l'intervallo (minimo secondo il piano).
  7. Premi Crea monitor.

Tipi e formato del target

TipoFormato del targetEsempio
lan_ping IP o hostname 192.168.1.10
nas.local
lan_tcp host:port 10.0.0.50:5432
192.168.1.20:22
lan_http URL completo http://nas.local
http://192.168.1.50:3000/healthz
Suggerimento - cosa scegliere per uno specifico dispositivo:
  • Router, switch, AP, stampante, telecamera - lan_ping basta. Rileva un'interruzione di corrente o un errore di rete.
  • Database, SSH, SMTP, RDP, VPN gateway - lan_tcp su una porta specifica. Rileva anche quando l'host è up ma il servizio è caduto.
  • NAS GUI, web interno, API locale - lan_http. Effettua una GET HTTP, accetta 2xx e 3xx.

Misurazioni sub-millisecondo

Per i target LAN il RTT è tipicamente inferiore a 1 millisecondo (ad es. 0,05 ms su un ethernet locale). ePulz.io memorizza response_ms come float con precisione di 3 decimali. Nei grafici e nella dashboard vedrai valori precisi invece dell'arrotondamento ai millisecondi interi.

Cosa succede al primo controllo

  1. Il monitor viene salvato con last_status = pending.
  2. L'agente al prossimo ciclo di pull (entro 30 s) riceve l'attività.
  3. Localmente esegue il check ping/TCP/HTTP.
  4. Invia il risultato indietro via HTTPS. Nella dashboard vedrai up o down con il response time.

Risoluzione dei problemi

  • Il monitor resta nello stato "pending" - controlla che l'agente sia in esecuzione (journalctl -u epulzio-agent -f o docker logs epulzio-agent).
  • Ping restituisce DOWN dall'agente, ma il ping dall'host funziona - nella variante Docker manca --network host; il container è in una rete isolata.
  • lan_http restituisce DOWN con errore SSL - il target ha un cert self-signed. Usa http:// invece di https:// per le applicazioni web interne.
  • Ricevo molti alert falsi positivi - aumenta notify_after_failures nel dettaglio del monitor (ad es. 3 = alert solo dopo 3 fallimenti consecutivi).

Correlati:

Gli alert email e Telegram per i monitor LAN funzionano allo stesso modo dei monitor cloud.

Notifiche