Ajuda e guiasAgentes LAN (rede interna) › Criar primeiro monitor LAN

Criar primeiro monitor LAN

4 min de leitura · Agentes LAN (rede interna)

Em resumo: Após instalar o agente você cria o monitor LAN pelo botão "Adicionar novo monitor". No dropdown de tipo selecione lan_ping, lan_tcp ou lan_http, preencha o target e selecione o agente da lista.

Passo a passo

  1. No dashboard clique em + Adicionar novo monitor.
  2. Insira um nome (por exemplo "NAS Synology - backups" ou "Impressora recepção").
  3. No campo Tipo de monitor selecione um dos tipos LAN - veja a tabela abaixo.
  4. No campo URL/hostname/host:port insira o target.
  5. No campo LAN agent selecione o agente que deve executar a verificação.
  6. Configure o Intervalo (mínimo conforme o plano).
  7. Pressione Criar monitor.

Tipos e formato do target

TipoFormato do targetExemplo
lan_ping IP ou hostname 192.168.1.10
nas.local
lan_tcp host:port 10.0.0.50:5432
192.168.1.20:22
lan_http URL completa http://nas.local
http://192.168.1.50:3000/healthz
Dica - o que escolher para cada dispositivo:
  • Router, switch, AP, impressora, câmera - lan_ping basta. Detecta queda de energia ou erro de rede.
  • Banco de dados, SSH, SMTP, RDP, VPN gateway - lan_tcp em porta específica. Detecta também quando o host roda, mas o serviço caiu.
  • NAS GUI, web interno, API local - lan_http. Chama HTTP GET, aceita 2xx e 3xx.

Medidas sub-milissegundo

Para targets LAN o RTT tipicamente é menor que 1 milissegundo (por exemplo 0,05 ms na ethernet local). O ePulz.io armazena response_ms como float com precisão de 3 casas decimais. Nos gráficos e no dashboard você vê valores exatos em vez de arredondamento para milissegundos inteiros.

O que acontece na primeira verificação

  1. O monitor é salvo com last_status = pending.
  2. O agente, no próximo ciclo de pull (em até 30 s), recebe a tarefa.
  3. Localmente executa o check ping/TCP/HTTP.
  4. Envia o resultado de volta via HTTPS. No dashboard você vê up ou down com response time.

Resolução de problemas

  • O monitor permanece no estado "pending" - verifique se o agente está rodando (journalctl -u epulzio-agent -f ou docker logs epulzio-agent).
  • O ping retorna DOWN do agente, mas o ping do host funciona - na variante Docker está faltando --network host; o container está em rede isolada.
  • lan_http retorna DOWN com erro SSL - o target tem cert self-signed. Use http:// em vez de https:// para aplicações web internas.
  • Estou recebendo muitos alertas falsos positivos - aumente notify_after_failures no detalhe do monitor (por exemplo 3 = alerta apenas após 3 falhas consecutivas).

Relacionado:

Os alertas por e-mail e Telegram para monitores LAN funcionam igual aos monitores cloud.

Notificações