Routeurs, switches et contrôleurs

Vos équipements réseau dans une seule vue

NetPulse reçoit des données via son agent natif, SNMP, des agents externes ou une balise intégrée au firmware du switch. La source adaptée dépend du logiciel que chaque appareil peut exécuter.

Compatibilité

Comment chaque plateforme se connecte

Voici les familles prises en charge et ce que chaque source apporte. La couverture exacte dépend du modèle et de son firmware.

Sources de données, couverture et prérequis par plateforme
Plateforme Source de données Données disponibles Prérequis et limites
OpenWrt et GL.iNet Agent natif sur le routeur Système, WiFi, clients et ports Installation depuis NetPulse sur les versions prises en charge
MikroTik RouterOS 7+ Pusher Go externe Hôtes, points d'accès et ports Utilisateur en lecture seule et machine pour le superviseur
Asuswrt / Asuswrt-Merlin Sondes et pusher sur le routeur Système, WiFi, clients et ports Accès SSH et espace persistant dans /jffs
Autres intégrations Poller de l'API locale de la BBox et beacon RTLPlayground BBox : système, WAN, hôtes et débits des ports. RTL : état des ports, débits et FDB BBox : API locale et machine pour le supervisor. RTL : avancé, remplacer le firmware avec une copie de récupération
UniFi Poller externe du contrôleur Passerelles, switches, AP et clients d'un site Sans cloud ui.com, CPU ni température
Switches administrables SNMP depuis NetPulse Ports, débits et voisins LLDP-MIB Les MIB disponibles dépendent de l'appareil
netpulse-integrations

Agents externes

MikroTik, Asuswrt et UniFi interrogent des routeurs ou des contrôleurs et envoient les données à NetPulse en HTTPS. La dernière carte regroupe des sources supplémentaires avec leur propre transport.

MikroTik RouterOS 7+

Interroge RouterOS et envoie les hôtes, points d'accès et ports.

  • Utilisateur en lecture seule et machine pour le superviseur
  • API binaire sur le port 8728, avec REST en secours
  • WiFi Wave2 annonce l'interface wifi et non capsman

Asuswrt et Asuswrt-Merlin

Le pusher fonctionne sur le routeur et réutilise les sondes portables de NetPulse. Il peut résider dans /jffs.

  • Accès SSH et espace persistant dans /jffs
  • Clients, radios, canaux et ports Ethernet
  • La couverture dépend du firmware et des outils installés

UniFi

Lit les passerelles, switches, points d'accès et clients d'un site sur votre contrôleur.

  • Consoles UniFi OS et contrôleurs autonomes hébergés par vous
  • Utilisateur en lecture seule sur le contrôleur
  • Sans comptes cloud ui.com, CPU ni température

et plus d'intégrations

Deux sources supplémentaires avec des exigences différentes.

  • BBox : interroge l'API locale et envoie système, WAN, hôtes actifs et débits de ports.
  • RTLPlayground : beacon en firmware pour les switches RTL8372/8373, avec état des ports, débits et FDB.
Firmware avancé

Une balise dans le switch

Les switches Realtek administrables par le web ne peuvent pas exécuter l'agent Go. Le fork RTLPlayground ajoute une balise qui envoie les données directement au listener NetPulse.

Ce que NetPulse reçoit

  • État et débit du lien toutes les 30 secondes
  • Débits de trafic calculés à partir des compteurs d'octets de chaque port
  • Table FDB toutes les cinq minutes pour localiser les clients par adresse MAC

Ce qu'il faut

  • Un modèle présent dans la liste des appareils RTLPlayground
  • Compiler le fork pour votre machine et définir l'identifiant du switch
  • Remplacer le firmware et disposer d'une sauvegarde et d'une méthode de restauration de la flash

La balise utilise UDP avec un jeton en clair dans un LAN de confiance. Elle n'utilise pas le transport HTTPS signé des agents externes.

Agents externes uniquement

Pourquoi un dépôt distinct

RouterOS, Asus, BBox et UniFi partagent un dépôt distinct. NetPulse maintient le contrat d'ingestion et chaque intégration suit le cycle de publication de son fabricant.

Cycles de vie distincts

Une intégration publie ses correctifs avec sa propre étiquette, sans attendre une release du serveur.

Identifiants isolés

Le mot de passe du routeur ou du contrôleur reste dans la configuration de l'intégration. NetPulse reçoit le jeton de l'agent.

Lecture seule

Ces intégrations lisent et envoient des données. Elles ne modifient pas la configuration des appareils depuis NetPulse.

Uniquement ce que vous activez

Le cœur n'exécute pas le code des intégrations que vous n'utilisez pas. Il reste léger et stable, et vous ajoutez seulement les agents nécessaires.

Transport des agents externes

Un contrat signé

L'agent signe chaque instantané avec HMAC-SHA256 dans l'en-tête X-Agent-Signature et l'envoie à l'ingestion NetPulse avec son jeton. L'appareil apparaît comme externe.

  • Un NetPulse accessible en HTTPS depuis l'emplacement de l'agent
  • Un jeton de routeur créé dans l'application
  • Un utilisateur en lecture seule sur le routeur ou le contrôleur

Compiler le superviseur

git clone https://github.com/gnacho/netpulse-integrations cd netpulse-integrations go build -o netpulse-integrations ./cmd/integrations-supervisor

Le dépôt publie des binaires statiques pour amd64 et arm64 avec SHA-256. Un exemple d'unité systemd est inclus.

Limites à connaître

  • Les agents externes ne configurent ni les routeurs ni les contrôleurs.
  • L'agent natif reste la source recommandée pour OpenWrt et GL.iNet.
  • La balise ne rapporte ni CPU, ni RAM, ni température, et n'envoie pas la table LLDP.
  • Un switch alimenté par balise ne peut pas ajouter SNMP comme seconde source dans NetPulse.
  • La balise du fork ne fait pas partie du projet RTLPlayground d'origine.

Commencez par votre appareil

Installez NetPulse et suivez le guide de votre plateforme.

Apparence
Thème