NetPulse recibe datos mediante su agente nativo, SNMP, agentes externos o un beacon integrado en el firmware del switch. La vía depende del software que pueda ejecutar cada equipo.
Estas son las familias soportadas y lo que puedes esperar de cada fuente. La cobertura concreta depende del modelo y de su firmware.
| Plataforma | Origen del dato | Datos disponibles | Requisitos y límites |
|---|---|---|---|
| OpenWrt y GL.iNet | Agente nativo en el router | Sistema, WiFi, clientes y puertos | Instalación desde NetPulse en versiones soportadas |
| MikroTik RouterOS 7+ | Pusher Go externo | Hosts, puntos de acceso y puertos | Usuario de solo lectura y equipo para el supervisor |
| Asuswrt / Asuswrt-Merlin | Sondas y supervisor en el router | Sistema, WiFi, clientes y puertos | Acceso SSH y espacio persistente en /jffs |
| Otras integraciones | Poller de la API de la BBox y beacon RTLPlayground | BBox: sistema, WAN, hosts y tasas de puertos. RTL: estado de puertos, tasas y FDB | BBox: API local y equipo para el supervisor. RTL: avanzado, sustituir firmware con copia de recuperación |
| UniFi | Poller externo del controlador | Gateways, switches, APs y clientes de un site | Sin nube ui.com, CPU ni temperatura |
| Switches gestionados | SNMP desde NetPulse | Puertos, velocidades y vecinos LLDP-MIB | La MIB disponible depende del dispositivo |
MikroTik, Asuswrt y UniFi consultan routers o controladores y envían los datos a NetPulse por HTTPS. La última tarjeta agrupa fuentes adicionales con su propio transporte.
Consulta RouterOS y envía hosts, puntos de acceso y puertos.
El pusher corre en el router y reutiliza las sondas portables de NetPulse. Puede residir en /jffs.
Lee gateways, switches, puntos de acceso y clientes de un site en tu controlador.
Dos fuentes adicionales con requisitos distintos.
Los switches Realtek web-managed no ejecutan el agente Go. El fork de RTLPlayground añade un beacon que envía datos directamente al listener de NetPulse.
El beacon usa UDP con un token en claro dentro de una LAN de confianza. No usa el transporte HTTPS firmado de los agentes externos.
RouterOS, Asus, BBox y UniFi comparten un repositorio separado. NetPulse mantiene el contrato de ingest y cada integración sigue el ritmo de su fabricante.
Una integración publica correcciones con su propia etiqueta, sin esperar a una versión del servidor.
La contraseña del router o controlador se queda en la configuración de la integración. NetPulse recibe el token del agente.
Estas integraciones consultan y envían datos. No cambian la configuración del equipo desde NetPulse.
El core no ejecuta código de integraciones que no usas. Se mantiene pequeño y estable, y añades únicamente los agentes que necesitas.
El agente firma cada instantánea con HMAC-SHA256 en la cabecera X-Agent-Signature y la envía al ingest de NetPulse con su token. El equipo aparece como external.
git clone https://github.com/gnacho/netpulse-integrations
cd netpulse-integrations
go build -o netpulse-integrations ./cmd/integrations-supervisor
El repositorio publica binarios estáticos para amd64 y arm64 con SHA-256. Incluye una unidad de systemd de ejemplo.
Instala NetPulse y sigue la guía correspondiente a tu plataforma.