Ayuda y guíasAgentes LAN (red interna) › Qué es LAN agent y cuándo usar

Qué es LAN agent y cuándo usar

4 min de lectura · Agentes LAN (red interna)

En resumen: El LAN agent es un pequeño programa que instala en cualquier máquina de la red interna del cliente. Desde Internet llama a ePulz.io, obtiene la lista de IP que debe comprobar, las pingea localmente y envía los resultados de vuelta. Gracias a esto monitoriza también dispositivos a los que la monitorización cloud no llega (NAS, cámaras, servidores internos, aplicaciones web locales).

Cuándo necesita el LAN agent

  • Monitorización de NAS y servidores domésticos/de empresa - Synology, QNAP, máquina propia con ZFS
  • Cámaras IP, sistemas de acceso, alarmas en tiendas u oficinas
  • Aplicaciones web internas - Grafana, Jira, GitLab, Bookstack tras el firewall
  • Infraestructura de red - router, switches, AP, VPN gateway
  • Dispositivos IoT y gateways - Modbus gateways, brokers MQTT
  • Escenario MSP - gestión de la monitorización para varios clientes con despliegue estandarizado

Cómo funciona

  1. En el panel crea un agente y obtiene un token plzag_… (se muestra solo una vez).
  2. Ejecuta el comando de instalación en una máquina de la red del cliente (Raspberry Pi, mini PC, NAS, host Docker).
  3. El agente pregunta a ePulz.io por tareas cada 30 segundos y realiza las comprobaciones localmente.
  4. Envía los resultados de vuelta por HTTPS: la misma conexión que usa cualquier navegador.
  5. Al cambiar el estado del dispositivo, ePulz.io dispara la notificación estándar (correo, Telegram, webhook).
Nota de seguridad importante: Toda la comunicación sale solo hacia fuera de su red (HTTPS saliente al puerto 443). Nunca necesita un port forward en el router, una IP pública estática ni un túnel VPN. Para la seguridad TI de la empresa del cliente, esto es típicamente tan aceptable como abrir Gmail.

Tres tipos de comprobaciones LAN

TipoDestinoQué detecta
lan_ping192.168.1.10El dispositivo responde a ICMP. La comprobación más barata.
lan_tcp10.0.0.50:5432Un puerto concreto está abierto. Aunque el host esté arriba, el servicio (BD, SSH, …) puede estar caído.
lan_httphttp://nas.localLa aplicación HTTP/HTTPS devuelve 2xx/3xx. GUI del NAS, dashboard interno.

Qué pasa cuando el agente se apaga

ePulz.io comprueba cada minuto si los agentes envían heartbeat. Si un agente no responde durante más de 5 minutos, recibirá un correo y un mensaje de Telegram: "El LAN agent X está offline". Cuando el agente vuelve, recibirá una notificación de back-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 mostramos la instalación del agente y la creación del primer monitor LAN.

Siguiente paso:

Instalación del LAN agent en una máquina de la red del cliente.

Instalación del agente →