O que é LAN agent e quando usar

4 min de leitura · Agentes LAN (rede interna)

Em resumo: O LAN agent é um pequeno programa que você instala em qualquer máquina dentro da rede interna do cliente. Da internet ele chama o ePulz.io, recebe a lista de IPs que deve verificar, faz o ping localmente e envia os resultados de volta. Graças a isso você monitora também dispositivos aos quais o monitoramento na nuvem não chega (NAS, câmeras, servidores internos, aplicações web locais).

Quando você precisa do LAN agent

Monitoramento de NAS e servidores domésticos/corporativos - Synology, QNAP, máquina própria com ZFS
Câmeras IP, sistemas de acesso, alarmes na loja ou no escritório
Aplicações web internas - Grafana, Jira, GitLab, Bookstack atrás de firewall
Infraestrutura de rede - router, switches, AP, gateway VPN
Dispositivos IoT e gateways - Modbus gateways, MQTT brokers
Cenário MSP - gestão de monitoramento para vários clientes com deployment padronizado

Como funciona

No dashboard você cria um agente e recebe o token plzag_... (exibido apenas uma vez).
Execute o comando de instalação na máquina dentro da rede do cliente (Raspberry Pi, mini PC, NAS, Docker host).
O agente pergunta ao ePulz.io as tarefas a cada 30 segundos e executa as verificações localmente.
Envia os resultados de volta via HTTPS - a mesma conexão que cada navegador usa.
Quando o estado do dispositivo muda, o ePulz.io dispara a notificação padrão (e-mail, Telegram, webhook).

Nota de segurança importante: Toda a comunicação vai apenas para fora da sua rede (HTTPS outbound na porta 443). Nunca é necessário port forward no router, IP pública estática nem túnel VPN. Para a segurança de TI da empresa do cliente, isto é tipicamente tão aceitável quanto abrir o Gmail.

Três tipos de verificações LAN

Tipo	Target	O que detecta
lan_ping	192.168.1.10	O dispositivo responde a ICMP. A verificação mais barata.
lan_tcp	10.0.0.50:5432	Uma porta específica está aberta. Mesmo que o host esteja rodando, o serviço (BD, SSH, ...) pode estar fora.
lan_http	http://nas.local	A aplicação HTTP/HTTPS retorna 2xx/3xx. GUI do NAS, dashboard interno.

O que acontece quando o agente apaga

O ePulz.io verifica a cada minuto se os agentes enviam heartbeat. Se o agente não responder por mais de 5 minutos, você recebe uma mensagem por e-mail e Telegram: "O LAN agent X está offline". Quando o agente volta, você recebe uma notificação de back-online. Graças a isso, não acontece de você ter uma falsa sensação de que tudo está rodando só porque o agente parou de enviar dados.

Comece

No próximo passo mostramos a instalação do agente e a criação do primeiro monitor LAN.

Próximo passo:

Instalação do LAN agent em uma máquina dentro da rede do cliente.

Instalação do agente