O que é LAN agent e quando usar
Em resumo: um agente LAN é um pequeno programa que você instala em qualquer computador dentro da rede interna do cliente. Pela internet conecta-se ao ePulz.io, solicita a lista de endereços que deve verificar, verifica-os localmente e envia os resultados de volta. Graças a isso você consegue monitorar até dispositivos que o monitoramento na nuvem não alcança (NAS, câmeras, servidores internos, aplicações web locais).
Quando você precisa de um agente LAN
- Monitoramento de NAS e servidores domésticos ou corporativos - Synology, QNAP, máquina própria com armazenamento ZFS
- Câmeras IP, sistemas de controle de acesso, alarmes em loja ou escritório
- Aplicações web internas - Grafana, Jira, GitLab, Bookstack atrás de firewall
- Infraestrutura de rede - router, switches, pontos de acesso (AP), gateway VPN
- Dispositivos IoT e gateways - gateways Modbus e MQTT e similares
- Cenário MSP - gestão de monitoramento para vários clientes com uma implantação unificada
Como funciona
- No dashboard você cria um agente e recebe um token (uma chave única)
epulzio_…- é exibido apenas uma vez. - Execute o comando de instalação em um dispositivo na rede do cliente (Raspberry Pi, mini PC, NAS, computador com Docker).
- A cada 30 segundos o agente pede novas tarefas ao ePulz.io e executa as verificações localmente.
- Envia os resultados de volta via HTTPS - a mesma conexão segura que cada navegador usa.
- Quando o estado de um dispositivo muda, o ePulz.io dispara a notificação padrão (e-mail, Telegram, webhook).
O que o agente envia (e o que nunca envia)
O agente envia exatamente três coisas:
- Heartbeat - versão do agente, hostname e nome do sistema operacional
- Resultados das verificações que você mesmo configurou - status up/down, tempo de resposta em ms e eventual mensagem de erro
- Nada mais. Ele nunca escaneia a rede, não lê arquivos, não coleta tráfego nem dados dos dispositivos. Cada endereço IP que ele toca é definido por você no dashboard.
- Token limitado: o token do agente permite apenas baixar a própria lista de verificações e enviar os resultados. Não tem acesso à sua conta, ao faturamento nem aos outros monitores, e você pode revogá-lo no dashboard a qualquer momento (Revoke).
- Roda sem privilégios de root: o serviço roda como usuário de sistema sem privilégios com um sandbox do systemd (NoNewPrivileges, ProtectSystem=strict). Root só é necessário durante a instalação.
- Totalmente auditável: o agente inteiro é um único arquivo Python (~600 linhas, apenas biblioteca padrão) - antes de executá-lo você pode ler cada linha.
Três tipos de verificações LAN
| Tipo | Alvo | O que detecta |
|---|---|---|
| lan_ping | 192.168.1.10 | O dispositivo responde a ICMP (um teste de rede simples). A verificação mais barata. |
| lan_tcp | 10.0.0.50:5432 | Uma porta específica está aberta. Mesmo que o dispositivo esteja rodando, o próprio serviço (banco de dados, SSH e similares) pode estar fora. |
| lan_http | http://nas.local | A aplicação HTTP ou HTTPS responde corretamente (códigos 2xx/3xx). Adequado para uma interface NAS ou um dashboard interno. |
O que acontece quando um agente para de funcionar
O ePulz.io verifica a cada minuto se os agentes enviam um sinal de vida (heartbeat). Se um agente não der sinal por mais de 5 minutos, você recebe um e-mail e uma mensagem no Telegram: "O agente LAN X está offline". Quando o agente volta, você recebe uma confirmação de que está online novamente. Graças a isso, não acontece de você ter a falsa sensação de que tudo está funcionando 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.