Intégration - SNMP

Développement
1

Bonjour à tous ! Je vous présente SNMP, une intégration externe pour Gladys 5.1+ qui lit vos équipements réseau en SNMP (v1, v2c, v3) et en fait des appareils Gladys : joignable ou non, temps de réponse, uptime, trafic, CPU, batterie… Tout reste en local, rien ne passe par un cloud.

Ce que fait l’intégration

Chaque équipement SNMP devient un appareil Gladys. Vous choisissez ce qu’il remonte avec des profils :

Profil Ce que Gladys reçoit Pour quels équipements
(toujours) Joignable (oui/non), temps de réponse (ms), uptime (jours) Tous
interfaces Par port : lien actif, débit entrant et sortant (kbit/s) Switchs, routeurs, bornes Wi-Fi
host Charge CPU, mémoire utilisée, disque le plus plein (%) NAS, serveurs Linux/Windows
ups Charge batterie, autonomie, batterie faible, présence secteur, tension, charge, puissance Onduleurs Eaton, APC avec carte réseau…
OID perso N’importe quel OID, avec catégorie, unité et échelle Tout le reste (température d’un NAS, toner…)

Un OID peut aussi être modifiable : il devient un interrupteur dans Gladys, piloté par un SET SNMP. Pratique pour une prise de PDU ou un port PoE.

Chaque appareil affiche un badge local, ou injoignable quand il ne répond plus.

Scènes et tableau de bord (Gladys 5.1)

Déclencheurs — un seul événement par changement, jamais à chaque interrogation :

  • Un agent SNMP ne répond plus (variables : nom, hôte, raison)
  • Un agent SNMP répond de nouveau (variables : nom, hôte, durée de la coupure en minutes)
  • Une interface réseau change d’état (filtre actif / tombé)

Actions de scène — elles n’arrêtent jamais la scène en cas d’échec, elles renvoient success et error :

  • Lire une valeur SNMP
  • Écrire une valeur SNMP (couper une prise de PDU, relancer un port PoE…)
  • Interroger un agent maintenant

Widget « Agents SNMP » — combien d’équipements répondent, une ligne par équipement avec son temps de réponse, un bouton « Interroger ». Choisissez un équipement dans ses réglages pour voir aussi ses valeurs en direct (CPU, mémoire, batterie…).

Exemple : « si l’onduleur passe sur batterie, m’envoyer un message et éteindre le NAS », ou « si la box ne répond plus depuis 5 minutes, couper puis rallumer sa prise ».

Installation et configuration

  1. Activez SNMP sur vos équipements. Le plus simple : v2c avec une communauté en lecture seule (choisissez la vôtre plutôt que public). SNMPv3 authPriv (SHA + AES) est supporté.
  2. Dans Gladys (5.1 minimum), installez l’intégration SNMP depuis le catalogue des intégrations.
  3. Dans l’onglet Configuration, listez vos équipements, séparés par des virgules, au format hôte[:port];nom;profils :
192.168.1.1;Routeur, 192.168.1.10;NAS;host, 192.168.1.20;Onduleur;ups
  1. Cliquez sur Tester la connexion : chaque équipement dit s’il répond, en combien de temps, et son nom système.
  2. Ajoutez les appareils depuis l’onglet Découverte.

Pour suivre des ports de switch, ajouter vos propres OID ou mettre des identifiants différents par équipement, collez plutôt une liste JSON (voir la documentation). Deux boutons aident à la remplir : Lister les interfaces (index et nom de chaque port) et Parcourir un OID (pour trouver la bonne valeur dans une MIB constructeur).

Limites connues

  • Pas de découverte automatique : les équipements se déclarent à la main.
  • Pas de traps SNMP pour l’instant, seulement de l’interrogation (une fois par minute au plus).
  • CPU, mémoire, disque et charge de l’onduleur sont affichés en catégorie « inconnue » avec une unité %, faute de catégorie Gladys adaptée.
  • Sur un gros réseau, montez l’intervalle de rafraîchissement (300 s par exemple) pour ne pas charger l’historique.

Liens et retours

C’est une première version : vos retours m’intéressent ! Dites-moi quels équipements vous avez testés (marque, modèle, version SNMP), ce qui marche, ce qui manque. Pour un bug, une issue GitHub avec les journaux (sans la communauté ni les clés) m’aide beaucoup.