NetPulse empfängt Daten über den nativen Agenten, SNMP, externe Agenten oder einen Beacon in der Switch-Firmware. Die passende Quelle hängt von der Software ab, die jedes Gerät ausführen kann.
Diese Familien werden unterstützt. Die genaue Abdeckung hängt vom Modell und seiner Firmware ab.
| Plattform | Datenquelle | Verfügbare Daten | Anforderungen und Grenzen |
|---|---|---|---|
| OpenWrt und GL.iNet | Nativer Agent auf dem Router | System, WLAN, Clients und Ports | Installation aus NetPulse auf unterstützten Versionen |
| MikroTik RouterOS 7+ | Externer Go-Pusher | Hosts, Access Points und Ports | Lesebenutzer und eine Maschine für den Supervisor |
| Asuswrt / Asuswrt-Merlin | Sonden und Pusher auf dem Router | System, WLAN, Clients und Ports | SSH-Zugang und dauerhafter Speicher in /jffs |
| Weitere Integrationen | Poller der lokalen BBox-API und RTLPlayground-Beacon | BBox: System, WAN, Hosts und Port-Raten. RTL: Portstatus, Raten und FDB | BBox: lokale API und Rechner für den Supervisor. RTL: fortgeschritten, Firmware mit Wiederherstellungskopie ersetzen |
| UniFi | Externer Controller-Poller | Gateways, Switches, APs und Clients eines Standorts | Keine ui.com-Cloud, CPU oder Temperatur |
| Verwaltete Switches | SNMP aus NetPulse | Ports, Geschwindigkeiten und LLDP-MIB-Nachbarn | Die verfügbaren MIBs hängen vom Gerät ab |
MikroTik, Asuswrt und UniFi fragen Router oder Controller ab und senden Daten per HTTPS an NetPulse. Die letzte Karte fasst zusätzliche Quellen mit eigenem Transport zusammen.
Fragt RouterOS ab und sendet Hosts, Access Points und Ports.
Der Pusher läuft auf dem Router und verwendet die portablen NetPulse-Sonden. Er kann in /jffs liegen.
Liest Gateways, Switches, Access Points und Clients eines Standorts auf deinem Controller.
Zwei zusätzliche Quellen mit unterschiedlichen Anforderungen.
Web-verwaltete Realtek-Switches können den Go-Agenten nicht ausführen. Der RTLPlayground-Fork ergänzt einen Beacon, der Daten direkt an den NetPulse-Listener sendet.
Der Beacon nutzt UDP mit einem Klartext-Token in einem vertrauenswürdigen LAN. Er verwendet nicht den signierten HTTPS-Transport der externen Agenten.
RouterOS, Asus, BBox und UniFi nutzen ein gemeinsames, separates Repository. NetPulse pflegt den Ingest-Vertrag und jede Integration folgt dem Release-Zyklus des Herstellers.
Eine Integration veröffentlicht Fixes unter ihrem eigenen Tag, ohne auf ein Server-Release zu warten.
Das Passwort des Routers oder Controllers bleibt in der Konfiguration der Integration. NetPulse erhält das Agent-Token.
Diese Integrationen fragen Daten ab und senden sie. Sie ändern keine Gerätekonfiguration aus NetPulse.
Der Kern führt keinen Code von Integrationen aus, die Sie nicht nutzen. Er bleibt klein und stabil, und Sie fügen nur die Agents hinzu, die Sie benötigen.
Der Agent signiert jeden Snapshot mit HMAC-SHA256 im Header X-Agent-Signature und sendet ihn mit seinem Token an den NetPulse-Ingest. Das Gerät erscheint als extern.
git clone https://github.com/gnacho/netpulse-integrations
cd netpulse-integrations
go build -o netpulse-integrations ./cmd/integrations-supervisor
Das Repository veröffentlicht statische Binärdateien für amd64 und arm64 mit SHA-256. Eine Beispiel-Systemd-Unit ist enthalten.
Installiere NetPulse und folge der Anleitung für deine Plattform.