APC-USV-Check-Referenz

Alle Parameter, Schwellenwerte und Konfigurationsoptionen für den APC-USV-Check in octoja — überwacht Batteriestatus, Last, Laufzeit, Eingangs- und Ausgangsspannung sowie Selbsttest-Ergebnisse per SNMP.

APC-USV-Check-Referenz

Der APC-USV-Check überwacht unterbrechungsfreie Stromversorgungen von APC per SNMP und erfasst Batteriestatus, Last, Laufzeit, Spannung und Selbsttest-Ergebnisse.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Host	String	Ja	—	Hostname oder IP-Adresse der USV
SNMP-Version	Auswahl (v2c / v3)	Ja	v2c	SNMP-Protokollversion zur Abfrage des Geräts
SNMP Community	String	Nein	public	SNMP-v2c-Community-String. Wird nur angezeigt, wenn die SNMP-Version v2c ist.
SNMPv3-Benutzer	String	Nein	—	USM-Benutzername. Wird nur angezeigt, wenn die SNMP-Version v3 ist.
Authentifizierungsprotokoll	Auswahl (Keine / SHA-1 / SHA-256)	Nein	Keine	Algorithmus zur Nachrichtenauthentifizierung. Wird nur angezeigt, wenn die SNMP-Version v3 ist.
Authentifizierungs-Passwort	Passwort	Nein	—	Wird nur angezeigt, wenn ein Authentifizierungsprotokoll ausgewählt ist.
Verschlüsselungsprotokoll	Auswahl (Keine / AES-128 / AES-192 / AES-256)	Nein	Keine	Algorithmus zur Nutzdatenverschlüsselung (erfordert Authentifizierung). Wird nur angezeigt, wenn ein Authentifizierungsprotokoll ausgewählt ist.
Verschlüsselungs-Passwort	Passwort	Nein	—	Wird nur angezeigt, wenn ein Verschlüsselungsprotokoll ausgewählt ist.

Batterie-Schwellenwerte

Feld	Typ	Erforderlich	Standard	Beschreibung
Batterie Warnung (%)	Prozent	Nein	50	Batterieladung auf oder unter diesem Wert löst eine Warnung aus
Batterie kritisch (%)	Prozent	Nein	25	Batterieladung auf oder unter diesem Wert löst ein kritisches Ergebnis aus

Laufzeit-Schwellenwerte

Feld	Typ	Erforderlich	Standard	Beschreibung
Laufzeit Warnung (Min)	Minuten	Nein	15	Geschätzte Laufzeit auf oder unter diesem Wert löst eine Warnung aus
Laufzeit kritisch (Min)	Minuten	Nein	5	Geschätzte Laufzeit auf oder unter diesem Wert löst ein kritisches Ergebnis aus

Last-Schwellenwerte

Feld	Typ	Erforderlich	Standard	Beschreibung
Last Warnung (%)	Prozent	Nein	80	Ausgangslast auf oder über diesem Wert löst eine Warnung aus
Last kritisch (%)	Prozent	Nein	95	Ausgangslast auf oder über diesem Wert löst ein kritisches Ergebnis aus

Spannungs-Schwellenwerte

Feld	Typ	Erforderlich	Standard	Beschreibung
Eingangsspannung niedrig (V)	Volt	Nein	210	Eingangsspannung unter diesem Wert löst eine Warnung aus
Eingangsspannung hoch (V)	Volt	Nein	250	Eingangsspannung über diesem Wert löst eine Warnung aus

Temperatur-Schwellenwerte

Feld	Typ	Erforderlich	Standard	Beschreibung
Temperaturwarnung (°C)	Zahl (°C)	Nein	40	Batterietemperatur ab diesem Wert löst eine Warnung aus
Temperatur kritisch (°C)	Zahl (°C)	Nein	50	Batterietemperatur ab diesem Wert löst ein kritisches Ergebnis aus

Die Temperaturgrenzen schließen den Grenzwert ein: Bei 40 °C gilt standardmäßig Warnung, bei 50 °C Kritisch. Fehlende, null oder negative Temperaturmesswerte lösen keinen Temperaturalarm aus und belegen nicht, dass die Batterie kühl ist. Vertauschte Warn- und Kritisch-Grenzen werden vor der Bewertung korrigiert.

Erfasste Metriken

Modell
Firmware-Version
USV-Status (online, Batteriebetrieb usw.)
Batterieladung (%)
Geschätzte Laufzeit (Minuten)
Ausgangslast (%)
Eingangsspannung (V)
Ausgangsspannung (V)
Eingangsfrequenz (Hz)
Ausgangsfrequenz (Hz)
Ausgangsstrom (A)
Batterietemperatur (°C)
Letztes Selbsttest-Ergebnis und -Datum
Letzter Umschaltgrund
Batterie muss ersetzt werden (true/false)
Batterie-Cartridge nähert sich dem Lebensdauerende (true/false)
Kommunikation OK (true/false)

Ergebniszustände

Bedingung	Schweregrad
USV über SNMP nicht erreichbar oder die USV meldet eine unterbrochene Kommunikation	Kritisch
USV-Status meldet Aus oder Unbekannt	Kritisch
Batterieladung auf oder unter dem kritischen Schwellenwert	Kritisch
Geschätzte Laufzeit auf oder unter dem kritischen Schwellenwert	Kritisch
Ausgangslast auf oder über dem kritischen Schwellenwert	Kritisch
Die USV meldet, dass die Batterie ersetzt werden muss	Kritisch
USV-Status meldet Batteriebetrieb	Warnung
Batterieladung auf oder unter dem Warn-Schwellenwert	Warnung
Geschätzte Laufzeit auf oder unter dem Warn-Schwellenwert	Warnung
Ausgangslast auf oder über dem Warn-Schwellenwert	Warnung
Eine Batterie-Cartridge nähert sich dem Lebensdauerende	Warnung
Der letzte Batterie-Selbsttest meldet Fehlgeschlagen	Warnung
Eingangsspannung unter dem unteren oder über dem oberen Schwellenwert	Warnung
Host leer gelassen	Warnung
Alle Messwerte innerhalb ihrer Schwellenwerte	OK

Das Gesamtergebnis ist der schlechteste Schweregrad unter den zutreffenden Bedingungen, und der Check listet jede gefundene Bedingung auf. Ist die Kommunikation mit der USV unterbrochen, meldet der Check nur das und liest nichts weiter aus.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja (netzwerkbasiert)
Linux	Ja (netzwerkbasiert)
macOS	Ja (netzwerkbasiert)

Der Check läuft auf dem Agent-Gerät und fragt die USV per SNMP über das Netzwerk ab, funktioniert also auf jedem Agent-Gerät, das die USV erreichen kann. Jede Plattform wird sowohl als x64- als auch als Arm64-Build ausgeliefert.

Hinweise

Erfordert SNMP (v2c oder v3), aktiviert auf der USV-Netzwerkmanagementkarte.
Der Check läuft standardmäßig alle 5 Minuten.
Du kannst den Check sowohl einem Netzwerkgerät als auch einem Agent-Gerät zuweisen.
Der Check verwendet Standard-APC-SNMP-OIDs. Er funktioniert mit APC Smart-UPS, Back-UPS Pro und Symmetra-Modellen mit Netzwerkmanagementkarte.
Die Spannungs-Schwellenwerte sollten an deinen lokalen Stromnetzstandard angepasst werden (z. B. 230 V ± 10 % in Europa, 120 V ± 10 % in Nordamerika).

Siehe auch: Einen APC-USV-Check konfigurieren