# Intégration - SNMP **URL:** \ **Category:** Développement\ **Tags:** integration-externe\ **Created:** [Octobre 14, 2026, 5:44 UTC](https://community.gladysassistant.com/t/integration-snmp/11219 "2026-10-14T17:44:55Z")\ **Posts on this page:** 3\ **Page:** 1
**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\ **Post date:** [Octobre 14, 2026, 5:44 UTC](https://community.gladysassistant.com/t/integration-snmp/11219/1 "2026-10-14T17:44:55Z")
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` : ```auto 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 - Code source : [github.com/prohand/gladys-snmp](https://github.com/prohand/gladys-snmp) - Documentation : [français](https://github.com/prohand/gladys-snmp/blob/main/docs/fr.md) · [English](https://github.com/prohand/gladys-snmp/blob/main/docs/en.md) · [Deutsch](https://github.com/prohand/gladys-snmp/blob/main/docs/de.md) · [Español](https://github.com/prohand/gladys-snmp/blob/main/docs/es.md) - Version actuelle : [v1.0.1](https://github.com/prohand/gladys-snmp/releases/tag/v1.0.1) 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. ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [Octobre 16, 2026, 9:56 UTC](https://community.gladysassistant.com/t/integration-snmp/11219/2 "2026-10-16T21:56:53Z")
Par hasard, ce n’est vraiment pas possible de permettre une découverte automatique ? Parce que là, à la main… C’est pas très user friendly ! 😇 ---
**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\ **Post date:** [Octobre 16, 2026, 10:16 UTC](https://community.gladysassistant.com/t/integration-snmp/11219/3 "2026-10-16T22:16:45Z")
Bonne idée, c’est fait ! 🙂 La **version 1.1.0** ajoute la découverte automatique. **Comment faire :** 1. Dans **Configuration** , mets ta **communauté SNMP** si ce n’est pas `public`, puis enregistre. 2. Va dans l’onglet **Découverte** et clique sur **Scanner**. 3. Les équipements qui répondent en SNMP apparaissent avec leur nom. Clique sur **Créer** pour ceux que tu veux suivre. Les profils `host` (CPU, mémoire, disques) et `ups` (onduleur) sont détectés tout seuls. Plus besoin de remplir la liste à la main. **Limites :** - Ça marche en SNMP v1/v2c, sur le port 161, sur le réseau local de Gladys. - Les équipements **uniquement en v3** , sur un autre port ou derrière un routeur se déclarent toujours dans la liste. - Certains équipements ne répondent pas aux requêtes en broadcast : il faut aussi les ajouter à la main. - Pense à réserver l’IP de tes équipements sur ton serveur DHCP. Si l’IP change, l’équipement réapparaît comme un nouvel appareil. Je n’ai pas encore pu tester sur beaucoup de matériel. Dis-moi ce que le scan trouve chez toi, ou ce qu’il rate, avec la marque et le modèle.