UniFi-(SNMP)-Checks konfigurieren

UniFi-(SNMP)-Checks konfigurieren

octoja überwacht Ubiquiti-UniFi-Hardware per SNMP mit drei getrennten Checks: UniFi (SNMP), UniFi Access Point (SNMP) und UniFi Switch (SNMP). Die drei lesen unterschiedliche Teile der Hardware aus, deshalb ist die Wahl des richtigen Checks wichtiger als jeder Schwellenwert, den du setzt. Die Arbeit teilt sich in zwei Hälften — SNMP in der UniFi Network Application einschalten und den richtigen Check auf das richtige Gerät richten.

Der Check läuft nicht auf dem UniFi-Gerät

Auf UniFi-Switches, Access Points und Gateways kann kein octoja-Agent laufen. Alle drei Checks sind agentenseitig: sie laufen auf einem von octoja verwalteten Gerät und fragen die UniFi-Hardware über das Netzwerk auf UDP-Port 161 ab. Für die Platzierung hast du zwei Möglichkeiten.

• Auf einem vorhandenen Agenten. Füge den Check einem beliebigen Gerät mit installiertem octoja-Agent hinzu, das die UniFi-Hardware erreicht — typischerweise ein Server oder eine Workstation im selben Netzwerk. Der Check liegt dann im Reiter Checks dieses Geräts.
• Auf dem UniFi-Gerät selbst, ohne Agent registriert. Füge den Switch, den Access Point oder das Gateway als Netzwerkgerät hinzu und gib ihm ein Überwachungsgerät; der Check wird am UniFi-Gerät gelistet, und das Überwachungsgerät übernimmt die Abfragen. octoja führt den Check gegen die eigene IP-Adresse dieses Netzwerkgeräts aus, der Host folgt also dem Gerät statt dem, was am Check hinterlegt ist. Siehe Ein Netzwerkgerät ohne Agent hinzufügen.

In beiden Fällen braucht das abfragende Gerät einen freien Weg zur LAN- oder Management-Adresse des UniFi-Geräts auf UDP 161. Richte den Check auf diese Adresse, nicht auf die öffentliche WAN-Adresse eines Gateways.

Welcher der drei Checks?

Der falsche Check auf einem Gerät scheitert nicht lautstark. Der allgemeine Check UniFi (SNMP) bleibt auf einem Switch grün und zeigt keine CPU-, RAM- oder Temperaturwerte — diese Werte liegen in einer MIB, die er nicht liest. UniFi Access Point (SNMP) steht auf allem, was kein Access Point ist, auf Warnung mit Keine Radio-Daten (SNMP / UBNT-UniFi-MIB aktivieren), weil die Radio-Tabelle, die er abläuft, leer zurückkommt. Sieh dir beim ersten Ergebnis die Kacheln an: Fehlen die Werte, die du erwartet hast, bist du auf dem falschen Check.

Die beiden Checks für Switches überschneiden sich nicht vollständig. UniFi Switch (SNMP) deckt die Hardware ab — CPU, RAM, Temperatur, Lüfter — und zählt Ports up und down. UniFi (SNMP) deckt das PoE-Budget ab, mit Warn- und Kritisch-Schwellenwerten auf den Verbrauch in Prozent dieses Budgets, und ergänzt Detailzeilen pro Port — aber nur für die Ports, auf die es ankommt: Ports, die administrativ up, betrieblich aber down sind, sowie jeder Port, den du unter Interfaces, die up sein müssen auswählst, gedeckelt bei 50 Zeilen. Ohne Auswahl zeigt ein gesunder Switch die Zusammenfassungszeile und gar keine Detailzeilen — jeder ausgewählte Port behält aber seine eigene Zeile, ob er up oder down ist. Auf einem PoE-Switch kannst du beide Checks gegen dieselbe Adresse laufen lassen, wenn du beide Signalgruppen willst. Antwortet ein Gerät nicht auf die PoE-MIB, lässt octoja den PoE-Abschnitt aus dem Ergebnis weg, statt Alarm zu schlagen.

Voraussetzungen

• Du brauchst die Berechtigung Monitoring-Check-Verwaltung (monitoring-checks.manage). Berechtigungen werden pro Gruppe unter Administration → Gruppen vergeben.
• Einen octoja-Agenten — oder ein agentenloses Netzwerkgerät mit Überwachungsgerät —, der die UniFi-Hardware über das Netzwerk erreicht.
• SNMP auf der UniFi-Seite aktiviert, mit dem Community-String oder den SNMPv3-Zugangsdaten zur Hand.

SNMP in der UniFi Network Application aktivieren

SNMP ist bei UniFi eine zentrale Einstellung, keine pro Gerät. Du schaltest es einmal in der UniFi Network Application ein, und der Controller verteilt es an jedes adoptierte Gerät — am Switch oder Access Point selbst ist nichts zu konfigurieren.

1. Melde dich an der UniFi Network Application an, die die Hardware adoptiert hat — deine UniFi-OS-Konsole, dein Cloud Key oder dein selbst gehosteter Controller.
2. Öffne Settings und suche den Abschnitt SNMP. Die Feldhilfe in octoja verweist auf Settings → System → SNMP, wo aktuelle Network-Versionen ihn führen. Liegt er in deiner Version woanders, durchsuche die Einstellungen nach SNMP — gesucht ist der Abschnitt mit dem Aktivierungsschalter und den Zugangsdaten für die SNMP-Versionen, die dein Controller unterstützt.
3. Aktiviere die Version, die dein Controller anbietet:
   • Community-based SNMP, dort als v1/v2c bezeichnet. Darauf verweisen auch die Check-Beschreibungen in octoja. Aktiviere sie und setze den Community-String — behandle ihn wie ein Passwort und geh weg von public.
   • SNMPv3, mit Benutzername und Passwort. Die Verfügbarkeit hängt von UniFi-Network-Version und Hardware-Generation ab. Nutze es, wenn dein Controller es anbietet: es authentifiziert und verschlüsselt, während ein v2c-Community-String im Klartext übertragen wird.
4. Speichere und gib den Geräten einen Moment. UniFi übernimmt die Einstellung, wenn jedes adoptierte Gerät das nächste Mal provisioniert — bis dahin antwortet es nicht. Bleibt ein Gerät stumm, während seine Nachbarn antworten, erzwinge dort eine Provisionierung.
5. Notiere die Adresse jedes Geräts, das du überwachen möchtest. Gemeint ist die eigene LAN-Adresse des Geräts, nicht die des Controllers — jeder Check wird auf den Switch, den Access Point oder das Gateway selbst gerichtet.

Die Oberfläche des UniFi-Controllers ändert sich zwischen Releases. Passt die Beschreibung oben nicht zu dem, was du siehst, durchsuche die Einstellungen nach SNMP. Unabhängig vom Layout konfigurierst du SNMP einmal für die gesamte Network Application, nicht am einzelnen Switch oder Access Point.

Controller in der Cloud? Für octoja ändert sich nichts

Ob die UniFi Network Application auf lokaler Hardware läuft oder in der Cloud gehostet ist (zum Beispiel eine Konsole, die du über unifi.ui.com erreichst), spielt für die Checks keine Rolle — für den Controller selbst gibt es nichts „hinzuzufügen“ oder anzubinden. Daraus folgen zwei Dinge:

• SNMP genauso aktivieren. Öffne deine cloud-gehostete Network Application im Browser, aktiviere SNMP unter Einstellungen → System → SNMP wie oben beschrieben — die Einstellung wird an jedes adoptierte Gerät am Standort verteilt, genau wie bei einem lokalen Controller.
• Die Checks fragen weiterhin lokal ab. Jeder Check fragt den Switch, den Access Point oder das Gateway an seiner LAN-Adresse ab — von einem octoja-verwalteten Gerät im selben Netzwerk. Richte einen Check nicht auf die Adresse der Cloud-Konsole oder eine öffentliche URL — der Controller antwortet nicht auf SNMP, und die UniFi-Geräte sind über das Internet nicht auf UDP 161 erreichbar.

Die einzige harte Voraussetzung bleibt damit dieselbe wie immer: ein Online-Gerät mit octoja Agent im selben Netzwerk wie die UniFi-Hardware. Die Cloud-Konsole selbst ist in octoja kein überwachbares Gerät.

Schritte

1. Gehe zu Geräte und öffne das Gerät, auf dem der Check laufen soll — dein agentenverwaltetes Gerät oder das agentenlose UniFi-Gerät selbst.
2. Klicke auf den Reiter Checks → Check hinzufügen und wähle dann UniFi (SNMP), UniFi Access Point (SNMP) oder UniFi Switch (SNMP).
3. Fülle den Verbindungsblock unten aus. Alles andere hat einen funktionierenden Standardwert.
4. Klicke auf Check hinzufügen.

Verbindungsfelder

Alle drei Checks teilen sich denselben Verbindungsblock — nur die Bezeichnung des Host-Felds unterscheidet sich.

Die v3-Felder bauen aufeinander auf, denn Verschlüsselung setzt Authentifizierung voraus: Steht Auth-Protokoll (v3) auf None, blendet octoja die Privacy-Felder ganz aus. Wähle zuerst ein Auth-Protokoll und sein Passwort, dann erscheint das Privacy-Paar darunter.

Der Rest des Formulars

Alles unterhalb des Verbindungsblocks funktioniert bereits mit seinem Standardwert, und die meisten dieser Felder tragen im Check-Editor keinen Hilfetext — deshalb hier vollständig. Welche davon du siehst, hängt vom Check ab.

Drei davon brauchen mehr als einen Standardwert, um sie gut zu nutzen.

• Interfaces, die up sein müssen in UniFi (SNMP) ist eine Auswahl, die aus den Ports des vorherigen Laufs gespeist wird — beim ersten Mal ist sie also leer. Speichere den Check, lass ihn einmal laufen, öffne ihn dann erneut und wähle deine Uplinks und geschäftskritischen Ports aus. Jeder ausgewählte Port, der down ist oder vom Gerät verschwunden ist, meldet Kritisch.
• Warnen, wenn ein Interface down ist in UniFi (SNMP) ist standardmäßig aus, und auf einem UniFi-Switch solltest du es aus lassen. Es warnt bei benannten Ports, die administrativ up, betrieblich aber down sind — und UniFi benennt auf einem Switch jeden Port, sodass ungenutzte Ports zusammen mit einem tatsächlich toten Uplink gemeldet werden. Nutze für gezielte Alarme stattdessen Interfaces, die up sein müssen.
• Client-Warnung pro Radio (0 = aus) in UniFi Access Point (SNMP) ist ab Werk aus. Setze den Wert auf die Client-Zahl, ab der du ein Radio als ausgelastet betrachtest, und der Check warnt, sobald ein Radio sie erreicht.

Wenn das Ergebnis nicht dem entspricht, was du erwartest

Tipps

• Die Standardintervalle unterscheiden sich: UniFi (SNMP) läuft alle 15 Minuten, die Access-Point- und Switch-Checks alle 5.
• Ein Check pro Gerät. Jeder Check fragt genau eine Adresse ab, ein Standort mit einem Gateway, drei Switches und acht Access Points braucht also einen Check pro Gerät.
• Denselben Check über viele Geräte auszurollen, ist die Aufgabe von Konfigurationspaketen — siehe Checks mit Konfigurationspaketen zuweisen.
• Bevorzuge SNMPv3, wo deine UniFi-Network-Version es anbietet. Ein v2c-Community-String wird unverschlüsselt übertragen.
• Wähle ein abfragendes Gerät, das online bleibt und im Netzwerk nah an der UniFi-Hardware sitzt. Geht es offline, gehen alle UniFi-Checks mit, die darauf laufen.
• Warn- und Kritisch-Schwellenwerte werden für dich sortiert: Trägst du einen Warnwert oberhalb des kritischen Werts ein, tauscht octoja beide, statt einen Alarm zu erzeugen, der nie auslösen kann.

Nach dem ersten Check-Intervall erscheint das Ergebnis im Reiter Checks des Geräts — mit Online-Status, Modell und den Messkacheln des jeweiligen Checks.

Siehe auch: Checks