Integration - SNMP

Entwicklung
1

Hallo zusammen! Ich stelle euch SNMP vor, eine externe Integration für Gladys 5.1+, die eure Netzwerkgeräte per SNMP (v1, v2c, v3) ausliest und daraus Gladys-Geräte macht: erreichbar oder nicht, Antwortzeit, Uptime, Verkehr, CPU, Batterie… Alles bleibt lokal, nichts geht über die Cloud.

Was die Integration macht

Jedes SNMP-Gerät wird zu einem Gladys-Gerät. Ihr wählt aus, was es mit Profilen hochlädt:

Profil Was Gladys erhält Für welche Geräte
(immer) Erreichbar (ja/nein), Antwortzeit (ms), Uptime (Tage) Alle
interfaces Pro Port: aktive Verbindung, eingehende und ausgehende Datenrate (kbit/s) Switches, Router, WLAN-Accesspoints
host CPU-Last, verwendeter Speicher, am vollsten belegter Datenträger (%) NAS, Linux/Windows-Server
ups Batterieladung, Laufzeit, Batterie schwach, Netzspannung vorhanden, Spannung, Ladung, Leistung Eaton- und APC-USVs mit Netzwerkkarte…
Benutzerdefinierter OID Beliebiger OID, mit Kategorie, Einheit und Skalierung Alles andere (Temperatur eines NAS, Toner…)

Ein OID kann auch änderbar sein: Er wird zu einem Schalter in Gladys, gesteuert durch ein SNMP-SET. Praktisch für eine PDU-Steckdose oder einen PoE-Port.

Jedes Gerät zeigt einen lokalen oder nicht erreichbaren Badge an, wenn es nicht mehr antwortet.

Szenen und Dashboard (Gladys 5.1)

Trigger — ein Ereignis pro Änderung, nie bei jeder Abfrage:

  • Ein SNMP-Agent antwortet nicht mehr (Variablen: Name, Host, Grund)
  • Ein SNMP-Agent antwortet wieder (Variablen: Name, Host, Dauer der Unterbrechung in Minuten)
  • Eine Netzwerkschnittstelle ändert ihren Zustand (aktiv/ausgefallen)

Szenenaktionen — sie stoppen die Szene im Fehlerfall nicht, sie geben success und error zurück:

  • SNMP-Wert lesen
  • SNMP-Wert schreiben (PDU-Steckdose ausschalten, PoE-Port neu starten…)
  • Agent jetzt abfragen

Widget „SNMP-Agenten“ — wie viele Geräte antworten, eine Zeile pro Gerät mit seiner Antwortzeit, ein „Abfragen“-Button. Wählt ein Gerät in seinen Einstellungen aus, um auch seine Live-Werte (CPU, Speicher, Batterie…) zu sehen.

Beispiel: „Wenn der USV auf Batterie geht, mir eine Nachricht schicken und das NAS ausschalten“, oder „Wenn der Router seit 5 Minuten nicht mehr antwortet, seine Steckdose ausschalten und wieder einschalten“.

Installation und Konfiguration

  1. Aktiviert SNMP auf euren Geräten. Am einfachsten: v2c mit einer read-only-Community (wählt eine eigene statt public). SNMPv3 authPriv (SHA + AES) wird unterstützt.
  2. In Gladys (mindestens 5.1), installiert die Integration SNMP aus dem Integrationskatalog.
  3. Im Tab Konfiguration, listet eure Geräte auf, durch Kommas getrennt, im Format host[:port];name;profile:
192.168.1.1;Router, 192.168.1.10;NAS;host, 192.168.1.20;USV;ups
  1. Klickt auf Verbindung testen: Jedes Gerät sagt, ob es antwortet, wie lange es dauert und seinen Systemnamen.
  2. Fügt die Geräte aus dem Tab Entdeckung hinzu.

Um Switch-Ports zu verfolgen, eigene OIDs hinzuzufügen oder unterschiedliche Anmeldedaten pro Gerät zu verwenden, fügt lieber eine JSON-Liste ein (siehe Dokumentation). Zwei Buttons helfen beim Ausfüllen: Schnittstellen auflisten (Index und Name jedes Ports) und OID durchsuchen (um den richtigen Wert in einer Hersteller-MIB zu finden).

Bekannte Einschränkungen

  • Keine automatische Entdeckung: Die Geräte werden manuell deklariert.
  • Keine SNMP-Traps bisher, nur Abfragen (höchstens einmal pro Minute).
  • CPU, Speicher, Datenträger und USV-Last werden in der Kategorie „unbekannt“ mit der Einheit % angezeigt, mangels passender Gladys-Kategorie.
  • In einem großen Netzwerk erhöht den Aktualisierungsintervall (z. B. 300 s), um den Verlauf nicht zu überlasten.

Links und Feedback

Es ist eine erste Version: Euer Feedback interessiert mich! Sagt mir, welche Geräte ihr getestet habt (Marke, Modell, SNMP-Version), was funktioniert, was fehlt. Für einen Bug hilft mir ein GitHub-Issue mit den Logs (ohne Community oder Schlüssel) sehr.