Skip to main content
UPS, power & environment

Generex UPS

Monitor UPS units with a Generex SNMP adapter through the RFC1628 UPS-MIB, including battery, runtime, phases and alarms.

The Generex UPS check reads the RFC1628 UPS-MIB from a Generex SNMP adapter. Use it to monitor battery charge, estimated remaining runtime, input and output phases, and active alarms. The default interval is 5 minutes.

Prerequisites

  • The adapter provides the RFC1628 UPS-MIB and permits SNMP queries from the device running the check.
  • That agent device can reach the adapter over UDP, using port 161 by default.
  • You know the adapter's SNMP v2c community or SNMPv3 credentials.
  • You can assign checks to the executing device; see Assign checks with config packages.

Steps

The upper section of the Generex UPS details with the host, SNMP version, connection settings and battery thresholds.

  1. Add Generex UPS to the check configuration of the executing agent device.
  2. Enter the adapter's hostname or IP address in Host and check the SNMP port.
  3. Choose the matching SNMP version. For v2c, enter the SNMP community. The default public must match the adapter configuration.
  4. For v3, enter the SNMPv3 user. If required, select an Authentication protocol (SHA-1 or SHA-256) and enter the Authentication password. With authentication enabled, you can also select AES-128, AES-192 or AES-256 as the Privacy protocol and enter the Privacy password. The protocols must match the adapter.
  5. Adjust Alert thresholds to suit the UPS and connected load, then save.
  6. After a run, open the check result. Check which measurements the adapter actually supplies, not just the overall status.

Settings

FieldTypeRequiredDefaultDescription
HostStringYes—Hostname or IP address of the Generex SNMP adapter
SNMP portIntegerYes161UDP port used by the SNMP agent
SNMP versionSelect (v2c / v3)Yesv2cSNMP protocol version used to query the adapter
SNMP communityPasswordYes (for v2c)publicSNMP v2c community string
SNMPv3 userStringYes (for v3)—USM user name
Authentication protocolSelect (None / SHA-1 / SHA-256)NoNoneShown only for v3
Authentication passwordPasswordYes (when shown)—Shown when an authentication protocol is selected
Privacy protocolSelect (None / AES-128 / AES-192 / AES-256)NoNoneShown when an authentication protocol is selected
Privacy passwordPasswordYes (when shown)—Shown when a privacy protocol is selected

Alert thresholds

All thresholds are integers. Battery and load percentages must be between 0 and 100.

The Generex UPS details scrolled to the lower thresholds for runtime, load, battery temperature and input voltage.

SettingDefaultEvaluation
Battery warning (%) / Battery critical (%)50 / 25Warning or critical when remaining charge is ≤ the threshold
Runtime warning (min) / Runtime critical (min)15 / 5Warning or critical when estimated remaining runtime is ≤ the threshold
Load warning (%) / Load critical (%)80 / 95Warning or critical when the highest reported output phase load is ≥ the threshold
Battery temperature warning (°C) / Battery temperature critical (°C)40 / 50Warning or critical when temperature is ≥ the threshold
Input voltage low (V) / Input voltage high (V)210 / 250Warning when an input phase is below 210 V or above 250 V; the boundaries themselves are allowed

If thresholds are reversed, the check orders each pair by meaning: the lower value is critical for battery and runtime, while the higher value is critical for load and temperature. Voltage values are sorted into lower and upper limits.

Results

The most severe finding determines the overall status. Besides your thresholds, the check considers the reported battery condition, power source and adapter alarms. Battery operation or bypass produces a warning, for example; a depleted battery or disabled UPS output produces a critical result. Unknown active alarms produce a warning.

Individual missing sensor values are skipped. Even OK may therefore be based on incomplete measurements. If the adapter returns no usable UPS telemetry at all, the check reports an error.

The detail view shows available battery and runtime values, power source, alarms and phase measurements. Issues lists the findings responsible for the status.

Troubleshooting

MessageWhat to check
Adapter did not respondCheck the host, UDP port, routing, firewall and SNMP access from the agent device
Access denied or authentication failedCompare the community or SNMPv3 user, protocol and password with the adapter configuration
Response could not be decryptedCheck that both sides use the same privacy protocol and password
No RFC1628 UPS data or UPS-MIB unavailableCheck adapter UPS-MIB support and SNMP read access
Invalid configurationCheck the host, port, credentials and percentage values from 0 to 100

Was this helpful?

Still need help? Ask the team