Qué es LAN agent y cuándo usar
En resumen: un agente LAN es un pequeño programa que instala en cualquier ordenador dentro de la red interna del cliente. A través de internet se conecta a ePulz.io, solicita la lista de direcciones que debe comprobar, las verifica localmente y envía los resultados de vuelta. Gracias a esto puede monitorizar incluso dispositivos a los que la monitorización en la nube no llega (NAS, cámaras, servidores internos, aplicaciones web locales).
Cuándo necesita un agente LAN
- Monitorización de NAS y servidores domésticos o de empresa - Synology, QNAP, máquina propia con almacenamiento ZFS
- Cámaras IP, sistemas de control de acceso, alarmas en una tienda u oficina
- Aplicaciones web internas - Grafana, Jira, GitLab, Bookstack tras el firewall
- Infraestructura de red - router, switches, puntos de acceso (AP), pasarela VPN
- Dispositivos IoT y pasarelas - pasarelas Modbus y MQTT y similares
- Escenario MSP - gestión de la monitorización para varios clientes con un despliegue unificado
Cómo funciona
- En el panel crea un agente y obtiene un token (una clave única)
epulzio_…- se muestra solo una vez. - Ejecuta el comando de instalación en un dispositivo de la red del cliente (Raspberry Pi, mini PC, NAS, ordenador con Docker).
- Cada 30 segundos el agente pregunta a ePulz.io por nuevas tareas y realiza las comprobaciones locales.
- Envía los resultados de vuelta por HTTPS - la misma conexión segura que usa cualquier navegador.
- Cuando cambia el estado de un dispositivo, ePulz.io dispara la notificación estándar (correo, Telegram, webhook).
Qué envía el agente (y qué no envía nunca)
El agente envía exactamente tres cosas:
- Heartbeat - versión del agente, hostname y nombre del sistema operativo
- Resultados de las comprobaciones que usted mismo configuró - estado up/down, tiempo de respuesta en ms y posible mensaje de error
- Nada más. Nunca escanea la red, no lee archivos, no recopila tráfico ni datos de los dispositivos. Cada dirección IP que toca la define usted en el panel.
- Token limitado: el token del agente solo permite descargar su propia lista de comprobaciones y enviar los resultados. No tiene acceso a su cuenta, a la facturación ni a otros monitores, y puede revocarlo en el panel en cualquier momento (Revoke).
- Funciona sin privilegios de root: el servicio se ejecuta como un usuario de sistema sin privilegios con un sandbox de systemd (NoNewPrivileges, ProtectSystem=strict). Root solo es necesario durante la instalación.
- Totalmente auditable: todo el agente es un único archivo Python (~600 líneas, solo biblioteca estándar) - antes de ejecutarlo puede leer cada línea.
Tres tipos de comprobaciones LAN
| Tipo | Destino | Qué detecta |
|---|---|---|
| lan_ping | 192.168.1.10 | El dispositivo responde a ICMP (una prueba de red sencilla). La comprobación más barata. |
| lan_tcp | 10.0.0.50:5432 | Un puerto concreto está abierto. Aunque el dispositivo esté funcionando, el servicio en sí (base de datos, SSH y similares) puede estar caído. |
| lan_http | http://nas.local | La aplicación HTTP o HTTPS responde correctamente (códigos 2xx/3xx). Adecuado para una interfaz NAS o un panel interno. |
Qué pasa cuando un agente deja de funcionar
ePulz.io comprueba cada minuto si los agentes envían una señal de vida (heartbeat). Si un agente no responde durante más de 5 minutos, recibirá un correo y un mensaje de Telegram: "El agente LAN X está offline". Cuando el agente vuelve, recibirá una confirmación de que está de nuevo online. Gracias a esto, no se quedará con la falsa sensación de que todo funciona solo porque el agente dejó de enviar datos.
Comience
En el siguiente paso le mostramos la instalación del agente y la creación del primer monitor LAN.
Siguiente paso:
Instalación del agente LAN en un dispositivo de la red del cliente.
Instalar el agente ->