CyberPower USV/ATS/PDU

Der Check CyberPower USV/ATS/PDU überwacht unterbrechungsfreie Stromversorgungen, automatische Umschalter und Rack-PDUs von CyberPower per SNMP. Je nach gewähltem Gerätetyp meldet er Batteriestatus, Ladung und Restlaufzeit, Ausgangslast, Eingangs- und Ausgangsspannung, den Status redundanter Eingänge und die Quelle, auf der ein Umschalter gerade läuft — so wirst du bei einem Stromproblem alarmiert, bevor ein Gerät ausfällt. Die Abfrage übernimmt ein octoja-Agent unter Windows, Linux oder macOS (jeweils x64 und Arm64) im selben Netzwerk; auf der Stromhardware selbst wird nichts installiert. Der Check läuft standardmäßig alle 5 Minuten.

Voraussetzungen

Der häufigste Grund dafür, dass dieser Check nie einen Messwert liefert: Das CyberPower-Gerät hat gar keine SNMP-Schnittstelle, mit der octoja sprechen könnte. Der Check fragt das Gerät über das Netzwerk ab — du brauchst also:

• Die Berechtigung Monitoring-Check-Verwaltung.
• Ein CyberPower-Gerät mit einer Netzwerk-Managementkarte (der RMCARD-Familie) oder einem eingebauten Management-Netzwerkport, erreichbar über eine IP-Adresse.
• SNMP auf dieser Karte aktiviert (v2c oder v3), mit Zugangsdaten, die octoja unterstützt — siehe unten.
• Einen octoja-Agent auf irgendeinem Gerät, das die Karte über UDP-Port 161 erreicht. Es muss kein Server sein, den die USV versorgt.

Eine USV, die nur per USB- oder seriellem Kabel an einem Server hängt, hat überhaupt keinen SNMP-Endpunkt. Einen Agent auf diesem Server zu installieren ändert daran nichts — der Agent ist nur der Aussichtspunkt, von dem aus dieser Check abfragt, und keine Einstellung darin bringt ihn dazu, eine lokal angeschlossene USV auszulesen. Rüste eine Managementkarte nach, wenn du die oben genannten Messwerte willst. Ist das keine Option, liest octojas separater Check Stromversorgung den Batteriezustand aus, den Windows selbst meldet — bei einer per USB angeschlossenen USV mit installiertem HID-Batterietreiber ist das die USV. Du bekommst damit Stromquelle, Ladestand und geschätzte Laufzeit, aber nichts von den SNMP-Details.

octoja fragt immer den UDP-Port 161 ab. Dieser Check hat kein Port-Feld — belasse den SNMP-Dienst der Karte also auf dem Standardport.

Das CyberPower-Gerät vorbereiten

Das erledigst du in der Weboberfläche der Managementkarte, bevor du den Check hinzufügst. Menünamen und Aufbau unterscheiden sich je nach Kartenmodell und Firmware-Version — suche also nach den SNMP-Einstellungen, statt einem festen Klickpfad zu folgen.

1. Gib der Karte eine IP-Adresse in einem Netzwerk, das dein octoja-Agent erreicht, und prüfe, dass der Host des Agents die Weboberfläche der Karte öffnen kann. Das belegt Routing und den grundlegenden Firewall-Pfad — SNMP braucht darüber hinaus noch UDP 161.
2. Aktiviere den SNMP-Dienst. octoja spricht SNMP v2c und SNMPv3. Führt die Karte v1 und v2c als getrennte Dienste, achte darauf, dass v2c aktiviert ist — octojas Anfragen sind v2c, und eine Karte, die nur v1 beantwortet, ignoriert sie.
3. Lege die Zugangsdaten an, die der Check nutzt: eine Read-Community für v2c oder einen Benutzer für v3 (siehe Tabelle unten). Lesezugriff genügt — der Check schreibt nie auf das Gerät, es gibt also keinen Grund, ihm eine Write-Community zu geben.
4. Führt die Karte eine Zugriffsliste erlaubter Manager- oder NMS-IP-Adressen, trage die IP-Adresse des octoja-Agents ein, der den Check ausführt. Ein fehlender Eintrag sieht exakt aus wie ein totes Gerät: Die Karte verwirft die Abfrage ohne Antwort, und octoja meldet einen Timeout.
5. Es gibt nirgends etwas zu importieren. octoja trägt CyberPowers SNMP-Objektbezeichner intern, du musst also keine MIB-Datei in octoja laden.

SNMPv3: die Kombinationen, die octoja unterstützt

Gehst du den v3-Weg, muss der Benutzer auf der Karte mit einer dieser Kombinationen eingerichtet sein. Alles andere scheitert an der Authentifizierung, selbst wenn Benutzername und Passwörter korrekt eingetippt sind.

Manche Hersteller bieten zwei Varianten von AES-192 und AES-256 an. octoja implementiert die gängige Variante von net-snmp. Heißen die Optionen deiner Karte AES-192-C / AES-256-C, ist das die andere (Cisco-)Variante — wähle stattdessen AES-128.

Schritte

Du kannst den Check sowohl einem Netzwerkgerät als auch einem Agent-Gerät zuweisen; wähle einen der beiden Wege.

Variante A — das CyberPower-Gerät als Netzwerkgerät registrieren

octoja kann die Stromhardware als eigenes agentenloses Gerät führen, abgefragt von einem deiner Agenten. Das Feld Host verschwindet dann aus dem Formular: octoja nutzt bei jedem Lauf die aktuelle IP-Adresse des Netzwerkgeräts, sodass eine spätere IP-Änderung automatisch übernommen wird, statt einen veralteten Wert stehen zu lassen.

1. Gehe zu Geräte und wähle Netzwerkgerät hinzufügen.
2. Wähle den Kunden, zu dem dieses Gerät gehört — der Dialog lässt die Speichern-Schaltfläche bis dahin deaktiviert —, trage dann einen Namen und die IP-Adresse oder Hostname der Managementkarte ein, wähle unter Überwachungsgeräte den Agenten, der sie erreicht, und setze Gerätetyp auf USV.
3. Speichere, öffne das neue Gerät und gehe dann auf den Reiter Checks → Check hinzufügen → CyberPower USV/ATS/PDU.
4. Wähle den passenden Gerätetyp, fülle die SNMP-Felder aus und klicke auf Check hinzufügen. Host wird hier nicht angezeigt — das ist so gewollt.

Ein Netzwerkgerät kann eigene SNMP-Einstellungen mitbringen — hinterlegt unter SNMP aktivieren im selben Dialog und genutzt für octojas Erreichbarkeits- und Inventarabfrage. Sind sie gesetzt, blendet der Check seine eigenen Felder für SNMP-Version und Zugangsdaten aus und fragt die Karte mit den SNMP-Einstellungen des Netzwerkgeräts ab. Ein dort hinterlegter abweichender SNMP-Port wird nicht übernommen — der Check fragt immer UDP 161 ab.

Variante B — den Check einem Gerät mit Agent hinzufügen

1. Gehe zu Geräte und öffne das Gerät, dessen Agent die CyberPower-Hardware erreicht.
2. Klicke auf den Reiter Checks → Check hinzufügen → CyberPower USV/ATS/PDU.
3. Trage den Hostnamen oder die IP-Adresse der Managementkarte in Host ein.
4. Wähle den passenden Gerätetyp, fülle die SNMP-Felder aus und klicke auf Check hinzufügen.

octoja füllt alle Schwellenwerte vor, du kannst sie im ersten Durchgang also unangetastet lassen — lies aber vorher die Hinweise zu den Schwellenwerten unten, denn die Standardwerte gehen von einer 230-V-Versorgung aus.

Einstellungen

Das Formular zeigt je nach zwei deiner Angaben unterschiedliche Felder. Die SNMP-Version bestimmt die Zugangsdaten-Felder: den Community-String für v2c, die Felder für Benutzer, Protokoll und Passwort für v3. Der Gerätetyp bestimmt die Schwellenwerte: Die Schwellenwerte für Batterie, Laufzeit und Last gehören zur USV, die Spannungs-Schwellenwerte gelten für jeden Gerätetyp außer PDU.

Batterie-Schwellenwerte — wird nur angezeigt, wenn der Gerätetyp USV ist

Spannungs-Schwellenwerte — wird für jeden Gerätetyp außer PDU angezeigt

Den richtigen Gerätetyp wählen

Das ist die eine Einstellung auf der octoja-Seite, die laut scheitert, wenn sie falsch ist. Jede Option lässt octoja einen anderen Teil des CyberPower-Datenmodells lesen, und eine USV hat nichts an der Stelle, wo die PDU-Werte liegen.

Passt der Typ nicht zur Hardware, wird der Check kritisch mit „Das Gerät lieferte keine Daten für den gewählten Gerätetyp.“ Sonst ist nichts kaputt — ändere den Typ, und der nächste Lauf fängt sich wieder.

Hinweise zu den Schwellenwerten

• Die Spannungsschwellen gehen von einer 230-V-Versorgung aus: Warnung unter 200 V, kritisch unter 190 V. Bei einer 100–120-V-Versorgung senkst du beide sofort, sonst steht der Check dauerhaft auf kritisch. Passe sie generell an deinen lokalen Netzstandard an (zum Beispiel 230 V in Europa, 120 V in Nordamerika).
• Die Batterieschwellen sind bewusst eng gesetzt (Warnung unter 95 %, kritisch unter 85 %). Eine USV, die nach einem Ausfall wieder lädt, durchläuft nicht nur eine Warnung: Jeder Ausfall, der sie unter 85 % entladen hat, lässt den Check kritisch bleiben, bis die Ladung wieder über diese Marke steigt, und danach auf Warnung, bis sie 95 % erreicht. Sollen Ladezyklen nicht alarmieren, senke Batterie Warnung (%) und Batterie kritisch (%) gemeinsam — nur den Warnwert zu senken lässt den kritischen Alarm exakt dort, wo er war. Halte den Warnwert über dem kritischen Wert: Trägst du eine Warnung unterhalb des kritischen Werts ein, vertauscht octoja beide stillschweigend.
• Vertauschte Warn- und Kritisch-Schwellenwerte (für Batterie, Laufzeit, Last und Spannung) korrigiert der Check vor der Auswertung automatisch.
• Ein PDU-Check hat überhaupt keine Schwellenwerte. Sein Status ergibt sich aus den Eingangswerten — meldet ein Eingang einen Fehler, wird der Check kritisch —, während die Stromaufnahme nur zur Information ausgewiesen wird.

Ergebnisse

Das Gesamtergebnis ist der schlechteste Schweregrad unter den zutreffenden Bedingungen. Zwei Details der Spannungs-Schwellenwerte solltest du kennen. Eine USV im Batteriebetrieb meldet eine Eingangsspannung von 0 V, deshalb bewertet der Check nur eine Eingangsspannung über null — der Batteriebetrieb ist für sich genommen bereits kritisch. Beim ATS oder ATS-PDU gibt es diese Ausnahme nicht: Die Spannungsschwellen gelten für beide Quellen, und ein toter Eingang liest sich als 0 V. Das ist Absicht — fällt einer von zwei Eingängen aus, löst das einen kritischen Alarm aus, auch wenn die angeschlossene Last nichts davon gemerkt hat.

Meldet die USV, dass ihre Batterie ersetzt werden muss, wird der Check kritisch, und die Detailansicht zeigt oben ein Banner, damit du den Tausch vor dem nächsten Ausfall einplanen kannst. Der Check erzeugt außerdem Verlaufsdiagramme für Batterieladung, Last, Spannungen und Stromaufnahme.

Erfasste Metriken

Die genauen Werte hängen vom Gerätetyp ab. Eine USV meldet ihren Strom- und Batteriezustand, ein ATS meldet, welche Quelle die Last speist und ob beide Eingänge gesund sind, und eine PDU meldet ihre Ausgangslast.

• Gerätemodell und Firmware-Version
• USV-Status — Online, Batteriebetrieb, Boost aktiv, Buck aktiv, ECO-Betrieb, Bypassbetrieb, Überlast, Ruhezustand, Neustart, Aus oder Unbekannt
• Batteriestatus — Normal, Schwach, Nicht vorhanden oder Unbekannt — und ob das Gerät meldet, dass die Batterie ersetzt werden muss
• Batteriekapazität (%) und Batterietemperatur (°C)
• Geschätzte Laufzeit (Minuten)
• Ausgangslast (%)
• Eingangsspannung (V) und Ausgangsspannung (V)
• Spannung von Quelle 1 und Quelle 2, welche Quelle gerade aktiv ist, und die Zahl der Umschaltereignisse (bei ATS-Geräten)
• Status jedes redundanten Eingangs und die Stromaufnahme (A) (bei PDU-Geräten)
• Ob die Kommunikation mit dem Gerät verloren ging und ob das Gerät einen aktiven Alarm meldet

Fehlerbehebung

Schlägt eine SNMP-Abfrage fehl, schreibt der Check den Grund direkt in sein Ergebnis. Ordne die Meldung der Ursache zu:

Tipps

• Konfiguriere einen Check pro Hardware. Überwachst du Stromhardware an vielen Standorten, rolle den Check mit einem Konfigurationspaket aus, statt ihn Gerät für Gerät hinzuzufügen.

Siehe auch: Checks mit Konfigurationspaketen zuweisen