Einen CyberPower-USV/ATS/PDU-Check konfigurieren

Einen CyberPower-USV/ATS/PDU-Check konfigurieren

Der Check CyberPower USV/ATS/PDU überwacht unterbrechungsfreie Stromversorgungen, automatische Umschalter und Rack-PDUs von CyberPower per SNMP — Batteriestatus, Ladung und Restlaufzeit, Ausgangslast, Eingangs- und Ausgangsspannung, den Status redundanter Eingänge und die Quelle, auf der ein Umschalter gerade läuft. Die Abfrage übernimmt ein octoja-Agent im selben Netzwerk; auf der Stromhardware selbst wird nichts installiert.

Fast die gesamte Arbeit liegt auf der CyberPower-Seite. Sobald die Managementkarte SNMP so beantwortet, wie octoja es erwartet, sind es im Check selbst vier Felder.

Fang hier an: octoja spricht mit der Netzwerkkarte, nicht mit dem USB-Kabel

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 alle drei Punkte:

• 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, in einer Version und 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 oben.

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 octoja anfasst. 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.

Den Check in octoja hinzufügen

Du benötigst die Berechtigung Monitoring-Check-Verwaltung. Es gibt zwei Wege, den Check zu platzieren; wähle einen.

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ät 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. Fülle die Felder unten 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. Trage den Community-String beziehungsweise die v3-Zugangsdaten auch im Check ein und halte beide Sätze identisch. Weichen Gerät und Check voneinander ab, kann die Karte am Ende mit Zugangsdaten abgefragt werden, die du nicht erwartest.

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. Fülle die restlichen Felder unten aus und klicke auf Check hinzufügen.

Die Felder, die du setzen musst

Alles darunter sind Schwellenwerte. octoja füllt sie alle vor und erklärt jeden einzelnen direkt im Editor, du kannst sie im ersten Durchgang also unangetastet lassen — lies aber vorher die beiden Hinweise unter Tipps, denn die Standardwerte gehen von einer 230-V-Versorgung aus.

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.

Wenn der Check nicht grün wird

Der Check schreibt den Grund direkt in sein Ergebnis. Ordne die Meldung der Ursache zu:

Tipps

• 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.
• 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.
• Bei einer ATS oder ATS-PDU gelten die Spannungsschwellen 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.
• 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.
• 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 läuft standardmäßig alle 5 Minuten und erzeugt Verlaufsdiagramme für Batterieladung, Last, Spannungen und Stromaufnahme.
• 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.

Nach dem ersten Check-Intervall erscheint das Ergebnis im Checks-Tab des Geräts.

Siehe auch: Checks mit Konfigurationspaketen zuweisen