All MIBs › UPS-MIB
Organization: IETF UPS MIB Working Group
Last Updated: 1994-02-23
Category: Hardware and Environment
Description: Defines managed objects for managing Uninterruptible Power Supply (UPS) systems, including battery status, input/output power measurements, alarms, and test controls.
IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring UPS-MIB with a free 30-day trial of IPNetwork Monitor.
What Is UPS-MIB?
UPS-MIB (RFC 1628) is a vendor-neutral IETF standards-track module for managing Uninterruptible Power Supply systems, applicable to UPS units from any manufacturer that implements it, making this UPS MIB one of the most widely implemented standard modules in power-monitoring deployments. It exposes identification data (manufacturer, model, firmware/software version), battery-related measurements, input/output power parameters, alarm conditions, and test/control objects. It is squarely a hardware-status monitoring MIB: it reports battery health (normal, low, depleted), estimated runtime and charge remaining, time already spent on battery, battery voltage and current, and the UPS's own firmware/software version, making it central to detecting an impending power failure or a degraded battery before it causes an outage. It has no significant dependency beyond the base SNMPv2-SMI framework, being a self-contained standard, and it is often paired with vendor-specific extension MIBs for proprietary features. It is typically deployed in data centers and server rooms, polled by monitoring systems to provide early warning of utility power loss or battery aging.
IPNetwork Monitor allows you to monitor SNMP objects defined in UPS-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.
Supported Devices
- vendor-neutral, standards-based MIB, not tied to a specific manufacturer
- Uninterruptible Power Supply (UPS) systems
Monitoring Examples
An administrator would poll upsBatteryStatus, upsSecondsOnBattery, upsEstimatedMinutesRemaining, and upsEstimatedChargeRemaining to watch a UPS's response during a power event; a upsBatteryStatus transition away from normal combined with a fast-dropping upsEstimatedMinutesRemaining signals an aging battery or an overloaded UPS that won't ride through the outage, while upsIdentUPSSoftwareVersion and upsIdentAttachedDevices help confirm firmware currency and load inventory.
What Can Be Monitored
- battery status (normal/low/depleted)
- estimated minutes remaining on battery
- estimated battery charge remaining
- time already spent on battery
- battery voltage and current
- UPS software/firmware version and attached device count
This MIB depends on
Related MIBs
Imported Objects
From SNMPv2-CONF
| MODULE-COMPLIANCE | |
| OBJECT-GROUP |
From SNMPv2-SMI
| Counter32 | |
| Gauge32 | |
| Integer32 | |
| MODULE-IDENTITY | |
| NOTIFICATION-TYPE | |
| OBJECT-IDENTITY | |
| OBJECT-TYPE | |
| mib-2 |
From SNMPv2-TC
| AutonomousType | |
| DisplayString | |
| TestAndIncr | |
| TimeInterval | |
| TimeStamp |
How to Use in IPNetwork Monitor
Example using upsBatteryCurrent OID:
Select an Uninterruptible Power Supply (UPS) system as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type upsBatteryCurrent into the Find box to locate it in the OID tree, then select it and click OK. It reports the UPS battery's present current, in units of 0.1 Amp DC. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is an Integer32-type OID, Value bounds is the most useful condition here — trigger an alert if the value drifts significantly from its normal charging/discharging baseline, since an unexpected current reading can indicate a battery or charging fault. Click Finish to create the monitor; you can adjust any parameter later.
See also: upsBatteryTemperature, upsEstimatedChargeRemaining
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| upsAlarm | 1.3.6.1.2.1.33.1.6 | |||
| upsAlarmAwaitingPower | 1.3.6.1.2.1.33.1.6.3.21 | The UPS output is off and the UPS is awaiting the return of input power. | ||
| upsAlarmBatteryBad | 1.3.6.1.2.1.33.1.6.3.1 | One or more batteries have been determined to require replacement. | ||
| upsAlarmBypassBad | 1.3.6.1.2.1.33.1.6.3.10 | The Bypass is out of tolerance. | ||
| upsAlarmChargerFailed | 1.3.6.1.2.1.33.1.6.3.13 | An uncorrected problem has been detected within the UPS charger subsystem. | ||
| upsAlarmCommunicationsLost | 1.3.6.1.2.1.33.1.6.3.20 | A problem has been encountered in the communications between the agent and the UPS. | ||
| upsAlarmDepletedBattery | 1.3.6.1.2.1.33.1.6.3.4 | The UPS will be unable to sustain the present load when and if the utility power is lost. | ||
| OID upsAlarmDescr | 1.3.6.1.2.1.33.1.6.2.1.2 | AutonomousType | read-only | A reference to an alarm description object. The object referenced should not be accessible, but rather be used to provide a unique description of the alarm condition. |
| upsAlarmDiagnosticTestFailed | 1.3.6.1.2.1.33.1.6.3.19 | The result of the last diagnostic test indicates a failure. | ||
| upsAlarmEntry | 1.3.6.1.2.1.33.1.6.2.1 | not-accessible | An entry containing information applicable to a particular alarm. | |
| upsAlarmFanFailure | 1.3.6.1.2.1.33.1.6.3.16 | The failure of one or more fans in the UPS has been detected. | ||
| upsAlarmFuseFailure | 1.3.6.1.2.1.33.1.6.3.17 | The failure of one or more fuses has been detected. | ||
| upsAlarmGeneralFault | 1.3.6.1.2.1.33.1.6.3.18 | A general fault in the UPS has been detected. | ||
| NUM upsAlarmId | 1.3.6.1.2.1.33.1.6.2.1.1 | PositiveInteger | not-accessible | A unique identifier for an alarm condition. This value must remain constant. |
| upsAlarmInputBad | 1.3.6.1.2.1.33.1.6.3.6 | An input condition is out of tolerance. | ||
| upsAlarmLowBattery | 1.3.6.1.2.1.33.1.6.3.3 | The remaining battery run-time is less than or equal to upsConfigLowBattTime. | ||
| upsAlarmOnBattery | 1.3.6.1.2.1.33.1.6.3.2 | The UPS is drawing power from the batteries. | ||
| upsAlarmOnBypass | 1.3.6.1.2.1.33.1.6.3.9 | The Bypass is presently engaged on the UPS. | ||
| upsAlarmOutputBad | 1.3.6.1.2.1.33.1.6.3.7 | An output condition (other than OutputOverload) is out of tolerance. | ||
| upsAlarmOutputOffAsRequested | 1.3.6.1.2.1.33.1.6.3.11 | The UPS has shutdown as requested, i.e., the output is off. | ||
| upsAlarmOutputOverload | 1.3.6.1.2.1.33.1.6.3.8 | The output load exceeds the UPS output capacity. | ||
| upsAlarmShutdownImminent | 1.3.6.1.2.1.33.1.6.3.23 | The UPS will turn off power to the load in less than 5 seconds; this may be either a timed shutdown or a low battery shutdown. | ||
| upsAlarmShutdownPending | 1.3.6.1.2.1.33.1.6.3.22 | A upsShutdownAfterDelay countdown is underway. | ||
| G32 upsAlarmsPresent | 1.3.6.1.2.1.33.1.6.1 | Gauge32 | read-only | The present number of active alarm conditions. |
| upsAlarmTable | 1.3.6.1.2.1.33.1.6.2 | not-accessible | A list of alarm table entries. The table contains zero, one, or many rows at any moment, depending upon the number of alarm conditions in effect. The table is initially empty at agent startup. The agent creates a row in the table each time a condition is detected and deletes that row when that condition no longer pertains. The agent creates the first row with upsAlarmId equal to 1, and increments the value of upsAlarmId each time a new row is created, wrapping to the first free value greater than or equal to 1 when the maximum value of upsAlarmId would otherwise be exceeded. Consequently, after multiple operations, the table may become sparse, e.g., containing entries for rows 95, 100, 101, and 203 and the entries should not be assumed to be in chronological order because upsAlarmId might have wrapped. Alarms are named by an AutonomousType (OBJECT IDENTIFIER), upsAlarmDescr, to allow a single table to reflect well known alarms plus alarms defined by a particular implementation, i.e., as documented in the private enterprise MIB definition for the device. No two rows will have the same value of upsAlarmDescr, since alarms define conditions. In order to meet this requirement, care should be taken in the definition of alarm conditions to insure that a system cannot enter the same condition multiple times simultaneously. The number of rows in the table at any given time is reflected by the value of upsAlarmsPresent. | |
| upsAlarmTempBad | 1.3.6.1.2.1.33.1.6.3.5 | A temperature is out of tolerance. | ||
| upsAlarmTestInProgress | 1.3.6.1.2.1.33.1.6.3.24 | A test is in progress, as initiated and indicated by the Test Group. Tests initiated via other implementation-specific mechanisms can indicate the presence of the testing in the alarm table, if desired, via a OBJECT-IDENTITY macro in the MIB document specific to that implementation and are outside the scope of this OBJECT-IDENTITY. | ||
| TIM upsAlarmTime | 1.3.6.1.2.1.33.1.6.2.1.3 | TimeStamp | read-only | The value of sysUpTime when the alarm condition was detected. If the alarm condition was detected at the time of agent startup and presumably existed before agent startup, the value of upsAlarmTime shall equal 0. |
| upsAlarmUpsOffAsRequested | 1.3.6.1.2.1.33.1.6.3.12 | The entire UPS has shutdown as commanded. | ||
| upsAlarmUpsOutputOff | 1.3.6.1.2.1.33.1.6.3.14 | The output of the UPS is in the off state. | ||
| upsAlarmUpsSystemOff | 1.3.6.1.2.1.33.1.6.3.15 | The UPS system is in the off state. | ||
| INT upsAutoRestart | 1.3.6.1.2.1.33.1.8.5 | INTEGER | read-write | Setting this object to 'on' will cause the UPS system to restart after a shutdown if the shutdown occurred during a power loss as a result of either a upsShutdownAfterDelay or an internal battery depleted condition. Setting this object to 'off' will prevent the UPS system from restarting after a shutdown until an operator manually or remotely explicitly restarts it. If the UPS is in a startup or reboot countdown, then the UPS will not restart until that delay has been satisfied. |
| upsBasicAlarmGroup | 1.3.6.1.2.1.33.3.2.2.6 | The upsBasicAlarmGroup defines the objects that are common to the Alarm groups of compliant UPSs which support basic functions. | ||
| upsBasicBatteryGroup | 1.3.6.1.2.1.33.3.2.2.2 | The upsBasicBatteryGroup defines the objects that are common to the battery groups of compliant UPSs which support basic functions. | ||
| upsBasicBypassGroup | 1.3.6.1.2.1.33.3.2.2.5 | The upsBasicBypassGroup defines the objects that are common to the Bypass groups of compliant UPSs which support basic functions. | ||
| upsBasicCompliance | 1.3.6.1.2.1.33.3.1.2 | The compliance statement for UPSs that support full-featured functions, such as control. | ||
| upsBasicConfigGroup | 1.3.6.1.2.1.33.3.2.2.9 | The upsBasicConfigGroup defines the objects that are common to the Config groups of UPSs which support basic functions. | ||
| upsBasicControlGroup | 1.3.6.1.2.1.33.3.2.2.8 | The upsBasicControlGroup defines the objects that are common to the Control groups of compliant UPSs which support basic functions. | ||
| upsBasicGroups | 1.3.6.1.2.1.33.3.2.2 | |||
| upsBasicIdentGroup | 1.3.6.1.2.1.33.3.2.2.1 | The upsBasicIdentGroup defines objects which are common to the Ident group of compliant UPSs which support basic functions. | ||
| upsBasicInputGroup | 1.3.6.1.2.1.33.3.2.2.3 | The upsBasicInputGroup defines the objects that are common to the Input groups of compliant UPSs which support basic functions. | ||
| upsBasicOutputGroup | 1.3.6.1.2.1.33.3.2.2.4 | The upsBasicOutputGroup defines the objects that are common to the Output groups of compliant UPSs which support basic functions. | ||
| upsBasicTestGroup | 1.3.6.1.2.1.33.3.2.2.7 | The upsBasicTestGroup defines the objects that are common to the Test groups of compliant UPSs which support basic functions. | ||
| upsBattery | 1.3.6.1.2.1.33.1.2 | |||
| I32 upsBatteryCurrentEx | 1.3.6.1.2.1.33.1.2.6 | Integer32 | read-only | The present battery current. |
| INT upsBatteryStatus | 1.3.6.1.2.1.33.1.2.1 | INTEGER | read-only | The indication of the capacity remaining in the UPS system's batteries. A value of batteryNormal indicates that the remaining run-time is greater than upsConfigLowBattTime. A value of batteryLow indicates that the remaining battery run-time is less than or equal to upsConfigLowBattTime. A value of batteryDepleted indicates that the UPS will be unable to sustain the present load when and if the utility power is lost (including the possibility that the utility power is currently absent and the UPS is unable to sustain the output). |
| I32 upsBatteryTemperatureEx | 1.3.6.1.2.1.33.1.2.7 | Integer32 | read-only | The ambient temperature at or near the UPS Battery casing. |
| NUM upsBatteryVoltage | 1.3.6.1.2.1.33.1.2.5 | NonNegativeInteger | read-only | The magnitude of the present battery voltage. |
| upsBypass | 1.3.6.1.2.1.33.1.5 | |||
| NUM upsBypassCurrent | 1.3.6.1.2.1.33.1.5.3.1.3 | NonNegativeInteger | read-only | The present bypass current. |
| upsBypassEntry | 1.3.6.1.2.1.33.1.5.3.1 | not-accessible | An entry containing information applicable to a particular bypass input. | |
| NUM upsBypassFrequency | 1.3.6.1.2.1.33.1.5.1 | NonNegativeInteger | read-only | The present bypass frequency. |
| NUM upsBypassLineIndex | 1.3.6.1.2.1.33.1.5.3.1.1 | PositiveInteger | not-accessible | The bypass line identifier. |
| NUM upsBypassNumLines | 1.3.6.1.2.1.33.1.5.2 | NonNegativeInteger | read-only | The number of bypass lines utilized in this device. This entry indicates the number of rows in the bypass table. |
| NUM upsBypassPower | 1.3.6.1.2.1.33.1.5.3.1.4 | NonNegativeInteger | read-only | The present true power conveyed by the bypass. |
| upsBypassTable | 1.3.6.1.2.1.33.1.5.3 | not-accessible | A list of bypass table entries. The number of entries is given by the value of upsBypassNumLines. | |
| NUM upsBypassVoltage | 1.3.6.1.2.1.33.1.5.3.1.2 | NonNegativeInteger | read-only | The present bypass voltage. |
| upsCompliances | 1.3.6.1.2.1.33.3.1 | |||
| upsConfig | 1.3.6.1.2.1.33.1.9 | |||
| INT upsConfigAudibleStatus | 1.3.6.1.2.1.33.1.9.8 | INTEGER | read-write | The requested state of the audible alarm. When in the disabled state, the audible alarm should never sound. The enabled state is self-describing. Setting this object to muted(3) when the audible alarm is sounding shall temporarily silence the alarm. It will remain muted until it would normally stop sounding and the value returned for read operations during this period shall equal muted(3). At the end of this period, the value shall revert to enabled(2). Writes of the value muted(3) when the audible alarm is not sounding shall be accepted but otherwise shall have no effect. |
| NUM upsConfigHighVoltageTransferPoint | 1.3.6.1.2.1.33.1.9.10 | NonNegativeInteger | read-write | The maximum line voltage allowed before the UPS system transfers to battery backup. |
| NUM upsConfigInputFreq | 1.3.6.1.2.1.33.1.9.2 | NonNegativeInteger | read-write | The nominal input frequency. On those systems which support read-write access to this object, if there is an attempt to set this variable to a value that is not supported, the request must be rejected and the agent shall respond with an appropriate error message, i.e., badValue for SNMPv1, or inconsistentValue for SNMPv2. |
| NUM upsConfigInputVoltage | 1.3.6.1.2.1.33.1.9.1 | NonNegativeInteger | read-write | The magnitude of the nominal input voltage. On those systems which support read-write access to this object, if there is an attempt to set this variable to a value that is not supported, the request must be rejected and the agent shall respond with an appropriate error message, i.e., badValue for SNMPv1, or inconsistentValue for SNMPv2. |
| NUM upsConfigLowBattTime | 1.3.6.1.2.1.33.1.9.7 | NonNegativeInteger | read-write | The value of upsEstimatedMinutesRemaining at which a lowBattery condition is declared. For agents which support only discrete (discontinuous) values, then the agent shall round up to the next supported value. If the requested value is larger than the largest supported value, then the largest supported value shall be selected. |
| NUM upsConfigLowVoltageTransferPoint | 1.3.6.1.2.1.33.1.9.9 | NonNegativeInteger | read-write | The minimum input line voltage allowed before the UPS system transfers to battery backup. |
| NUM upsConfigOutputFreq | 1.3.6.1.2.1.33.1.9.4 | NonNegativeInteger | read-write | The nominal output frequency. On those systems which support read-write access to this object, if there is an attempt to set this variable to a value that is not supported, the request must be rejected and the agent shall respond with an appropriate error message, i.e., badValue for SNMPv1, or inconsistentValue for SNMPv2. |
| NUM upsConfigOutputPower | 1.3.6.1.2.1.33.1.9.6 | NonNegativeInteger | read-only | The magnitude of the nominal true power rating. |
| NUM upsConfigOutputVA | 1.3.6.1.2.1.33.1.9.5 | NonNegativeInteger | read-only | The magnitude of the nominal Volt-Amp rating. |
| NUM upsConfigOutputVoltage | 1.3.6.1.2.1.33.1.9.3 | NonNegativeInteger | read-write | The magnitude of the nominal output voltage. On those systems which support read-write access to this object, if there is an attempt to set this variable to a value that is not supported, the request must be rejected and the agent shall respond with an appropriate error message, i.e., badValue for SNMPv1, or inconsistentValue for SNMPv2. |
| upsConformance | 1.3.6.1.2.1.33.3 | |||
| upsControl | 1.3.6.1.2.1.33.1.8 | |||
| INT upsEstimatedChargeRemainingEx | 1.3.6.1.2.1.33.1.2.4 | INTEGER | read-only | An estimate of the battery charge remaining expressed as a percent of full charge. |
| NUM upsEstimatedMinutesRemaining | 1.3.6.1.2.1.33.1.2.3 | PositiveInteger | read-only | An estimate of the time to battery charge depletion under the present load conditions if the utility power is off and remains off, or if it were to be lost and remain off. |
| upsFullAlarmGroup | 1.3.6.1.2.1.33.3.2.3.6 | The upsFullAlarmGroup defines the objects that are common to the Alarm groups of fully compliant UPSs. | ||
| upsFullBatteryGroup | 1.3.6.1.2.1.33.3.2.3.2 | The upsFullBatteryGroup defines the objects that are common to the battery groups of fully compliant UPSs. | ||
| upsFullBypassGroup | 1.3.6.1.2.1.33.3.2.3.5 | The upsFullBypassGroup defines the objects that are common to the Bypass groups of fully compliant UPSs. | ||
| upsFullCompliance | 1.3.6.1.2.1.33.3.1.3 | The compliance statement for UPSs that support advanced full-featured functions. | ||
| upsFullConfigGroup | 1.3.6.1.2.1.33.3.2.3.9 | The upsFullConfigGroup defines the objects that are common to the Config groups of fully compliant UPSs. | ||
| upsFullControlGroup | 1.3.6.1.2.1.33.3.2.3.8 | The upsFullControlGroup defines the objects that are common to the Control groups of fully compliant UPSs. | ||
| upsFullGroups | 1.3.6.1.2.1.33.3.2.3 | |||
| upsFullIdentGroup | 1.3.6.1.2.1.33.3.2.3.1 | The upsFullIdentGroup defines objects which are common to the Ident group of fully compliant UPSs. | ||
| upsFullInputGroup | 1.3.6.1.2.1.33.3.2.3.3 | The upsFullInputGroup defines the objects that are common to the Input groups of fully compliant UPSs. | ||
| upsFullOutputGroup | 1.3.6.1.2.1.33.3.2.3.4 | The upsFullOutputGroup defines the objects that are common to the Output groups of fully compliant UPSs. | ||
| upsFullTestGroup | 1.3.6.1.2.1.33.3.2.3.7 | The upsFullTestGroup defines the objects that are common to the Test groups of fully compliant UPSs. | ||
| upsGroups | 1.3.6.1.2.1.33.3.2 | |||
| upsIdent | 1.3.6.1.2.1.33.1.1 | |||
| STR upsIdentAgentSoftwareVersion | 1.3.6.1.2.1.33.1.1.4 | DisplayString | read-only | The UPS agent software version. This variable may or may not have the same value as upsIdentUPSSoftwareVersion in some implementations. |
| STR upsIdentAttachedDevices | 1.3.6.1.2.1.33.1.1.6 | DisplayString | read-write | A string identifying the devices attached to the output(s) of the UPS. This object should be set by the administrator. |
| STR upsIdentManufacturer | 1.3.6.1.2.1.33.1.1.1 | DisplayString | read-only | The name of the UPS manufacturer. |
| STR upsIdentModel | 1.3.6.1.2.1.33.1.1.2 | DisplayString | read-only | The UPS Model designation. |
| STR upsIdentName | 1.3.6.1.2.1.33.1.1.5 | DisplayString | read-write | A string identifying the UPS. This object should be set by the administrator. |
| STR upsIdentUPSSoftwareVersion | 1.3.6.1.2.1.33.1.1.3 | DisplayString | read-only | The UPS firmware/software version(s). This variable may or may not have the same value as upsIdentAgentSoftwareVersion in some implementations. |
| upsInput | 1.3.6.1.2.1.33.1.3 | |||
| NUM upsInputCurrent | 1.3.6.1.2.1.33.1.3.3.1.4 | NonNegativeInteger | read-only | The magnitude of the present input current. |
| upsInputEntry | 1.3.6.1.2.1.33.1.3.3.1 | not-accessible | An entry containing information applicable to a particular input line. | |
| NUM upsInputFrequency | 1.3.6.1.2.1.33.1.3.3.1.2 | NonNegativeInteger | read-only | The present input frequency. |
| C32 upsInputLineBads | 1.3.6.1.2.1.33.1.3.1 | Counter32 | read-only | A count of the number of times the input entered an out-of-tolerance condition as defined by the manufacturer. This count is incremented by one each time the input transitions from zero out-of-tolerance lines to one or more input lines out-of-tolerance. |
| NUM upsInputLineIndex | 1.3.6.1.2.1.33.1.3.3.1.1 | PositiveInteger | not-accessible | The input line identifier. |
| NUM upsInputNumLines | 1.3.6.1.2.1.33.1.3.2 | NonNegativeInteger | read-only | The number of input lines utilized in this device. This variable indicates the number of rows in the input table. |
| upsInputTable | 1.3.6.1.2.1.33.1.3.3 | not-accessible | A list of input table entries. The number of entries is given by the value of upsInputNumLines. | |
| NUM upsInputTruePower | 1.3.6.1.2.1.33.1.3.3.1.5 | NonNegativeInteger | read-only | The magnitude of the present input true power. |
| NUM upsInputVoltage | 1.3.6.1.2.1.33.1.3.3.1.3 | NonNegativeInteger | read-only | The magnitude of the present input voltage. |
| upsMIB | 1.3.6.1.2.1.33 | The MIB module to describe Uninterruptible Power Supplies. | ||
| upsObjects | 1.3.6.1.2.1.33.1 | |||
| upsOutput | 1.3.6.1.2.1.33.1.4 | |||
| NUM upsOutputCurrent | 1.3.6.1.2.1.33.1.4.4.1.3 | NonNegativeInteger | read-only | The present output current. |
| upsOutputEntry | 1.3.6.1.2.1.33.1.4.4.1 | not-accessible | An entry containing information applicable to a particular output line. | |
| NUM upsOutputFrequency | 1.3.6.1.2.1.33.1.4.2 | NonNegativeInteger | read-only | The present output frequency. |
| NUM upsOutputLineIndex | 1.3.6.1.2.1.33.1.4.4.1.1 | PositiveInteger | not-accessible | The output line identifier. |
| NUM upsOutputNumLines | 1.3.6.1.2.1.33.1.4.3 | NonNegativeInteger | read-only | The number of output lines utilized in this device. This variable indicates the number of rows in the output table. |
| INT upsOutputPercentLoad | 1.3.6.1.2.1.33.1.4.4.1.5 | INTEGER | read-only | The percentage of the UPS power capacity presently being used on this output line, i.e., the greater of the percent load of true power capacity and the percent load of VA. |
| NUM upsOutputPower | 1.3.6.1.2.1.33.1.4.4.1.4 | NonNegativeInteger | read-only | The present output true power. |
| INT upsOutputSource | 1.3.6.1.2.1.33.1.4.1 | INTEGER | read-only | The present source of output power. The enumeration none(2) indicates that there is no source of output power (and therefore no output power), for example, the system has opened the output breaker. |
| upsOutputTable | 1.3.6.1.2.1.33.1.4.4 | not-accessible | A list of output table entries. The number of entries is given by the value of upsOutputNumLines. | |
| NUM upsOutputVoltage | 1.3.6.1.2.1.33.1.4.4.1.2 | NonNegativeInteger | read-only | The present output voltage. |
| INT upsRebootWithDuration | 1.3.6.1.2.1.33.1.8.4 | INTEGER | read-write | Setting this object will immediately shutdown (i.e., turn off) either the UPS output or the UPS system (as determined by the value of upsShutdownType at the time of shutdown) for a period equal to the indicated number of seconds, after which time the output will be started, including starting the UPS, if necessary. If the number of seconds required to perform the request is greater than the requested duration, then the requested shutdown and startup cycle shall be performed in the minimum time possible, but in no case shall this require more than the requested duration plus 60 seconds. When read, upsRebootWithDuration shall return the number of seconds remaining in the countdown, or -1 if no countdown is in progress. If the startup should occur during a utility failure, the startup shall not occur until the utility power is restored. |
| NUM upsSecondsOnBattery | 1.3.6.1.2.1.33.1.2.2 | NonNegativeInteger | read-only | If the unit is on battery power, the elapsed time since the UPS last switched to battery power, or the time since the network management subsystem was last restarted, whichever is less. Zero shall be returned if the unit is not on battery power. |
| INT upsShutdownAfterDelay | 1.3.6.1.2.1.33.1.8.2 | INTEGER | read-write | Setting this object will shutdown (i.e., turn off) either the UPS output or the UPS system (as determined by the value of upsShutdownType at the time of shutdown) after the indicated number of seconds, or less if the UPS batteries become depleted. Setting this object to 0 will cause the shutdown to occur immediately. Setting this object to -1 will abort the countdown. If the system is already in the desired state at the time the countdown reaches 0, then nothing will happen. That is, there is no additional action at that time if upsShutdownType = system and the system is already off. Similarly, there is no additional action at that time if upsShutdownType = output and the output is already off. When read, upsShutdownAfterDelay will return the number of seconds remaining until shutdown, or -1 if no shutdown countdown is in effect. On some systems, if the agent is restarted while a shutdown countdown is in effect, the countdown may be aborted. Sets to this object override any upsShutdownAfterDelay already in effect. |
| INT upsShutdownType | 1.3.6.1.2.1.33.1.8.1 | INTEGER | read-write | This object determines the nature of the action to be taken at the time when the countdown of the upsShutdownAfterDelay and upsRebootWithDuration objects reaches zero. Setting this object to output(1) indicates that shutdown requests should cause only the output of the UPS to turn off. Setting this object to system(2) indicates that shutdown requests will cause the entire UPS system to turn off. |
| INT upsStartupAfterDelay | 1.3.6.1.2.1.33.1.8.3 | INTEGER | read-write | Setting this object will start the output after the indicated number of seconds, including starting the UPS, if necessary. Setting this object to 0 will cause the startup to occur immediately. Setting this object to -1 will abort the countdown. If the output is already on at the time the countdown reaches 0, then nothing will happen. Sets to this object override the effect of any upsStartupAfterDelay countdown or upsRebootWithDuration countdown in progress. When read, upsStartupAfterDelay will return the number of seconds until startup, or -1 if no startup countdown is in effect. If the countdown expires during a utility failure, the startup shall not occur until the utility power is restored. On some systems, if the agent is restarted while a startup countdown is in effect, the countdown is aborted. |
| upsSubsetAlarmGroup | 1.3.6.1.2.1.33.3.2.1.6 | The upsSubsetAlarmGroup defines the objects that are common to the Alarm groups of two-contact UPSs. | ||
| upsSubsetBatteryGroup | 1.3.6.1.2.1.33.3.2.1.2 | The upsSubsetBatteryGroup defines the objects that are common to battery groups of two-contact UPSs. | ||
| upsSubsetCompliance | 1.3.6.1.2.1.33.3.1.1 | The compliance statement for UPSs that only support the two-contact communication protocol. | ||
| upsSubsetConfigGroup | 1.3.6.1.2.1.33.3.2.1.9 | The upsSubsetConfigGroup defines the objects that are common to the Config groups of two-contact UPSs. | ||
| upsSubsetControlGroup | 1.3.6.1.2.1.33.3.2.1.8 | The upsSubsetControlGroup defines the objects that are common to the Control groups of two-contact UPSs. | ||
| upsSubsetGroups | 1.3.6.1.2.1.33.3.2.1 | |||
| upsSubsetIdentGroup | 1.3.6.1.2.1.33.3.2.1.1 | The upsSubsetIdentGroup defines objects which are common across all UPSs which meet subset compliance. Most devices which conform to the upsSubsetIdentGroup will provide access to these objects via a proxy agent. If the proxy agent is compatible with multiple UPS types, configuration of the proxy agent will require specifying some of these values, either individually, or as a group (perhaps through a table lookup mechanism based on the UPS model number). | ||
| upsSubsetInputGroup | 1.3.6.1.2.1.33.3.2.1.3 | The upsSubsetInputGroup defines the objects that are common to the Input groups of two-contact UPSs. | ||
| upsSubsetOutputGroup | 1.3.6.1.2.1.33.3.2.1.4 | The upsSubsetOutputGroup defines the objects that are common to the Output groups of two-contact UPSs. | ||
| upsTest | 1.3.6.1.2.1.33.1.7 | |||
| upsTestAbortTestInProgress | 1.3.6.1.2.1.33.1.7.7.2 | The test in progress is to be aborted / the test in progress was aborted. | ||
| upsTestDeepBatteryCalibration | 1.3.6.1.2.1.33.1.7.7.5 | The system is placed on battery to a discharge level, set by the manufacturer, sufficient to determine battery replacement and battery run-time with a high degree of confidence. WARNING: this test will leave the battery in a low charge state and will require time for recharging to a level sufficient to provide normal battery duration for the protected load. | ||
| NUM upsTestElapsedTime | 1.3.6.1.2.1.33.1.7.6 | TimeInterval | read-only | The amount of time, in TimeTicks, since the test in progress was initiated, or, if no test is in progress, the previous test took to complete. If the value of upsTestResultsSummary is noTestsInitiated(6), upsTestElapsedTime has the value 0. |
| upsTestGeneralSystemsTest | 1.3.6.1.2.1.33.1.7.7.3 | The manufacturer's standard test of UPS device systems. | ||
| OID upsTestId | 1.3.6.1.2.1.33.1.7.1 | OBJECT IDENTIFIER | read-write | The test is named by an OBJECT IDENTIFIER which allows a standard mechanism for the initiation of tests, including the well known tests identified in this document as well as those introduced by a particular implementation, i.e., as documented in the private enterprise MIB definition for the device. Setting this variable initiates the named test. Sets to this variable require the presence of upsTestSpinLock in the same SNMP message. The set request will be rejected with an appropriate error message if the requested test cannot be performed, including attempts to start a test when another test is already in progress. The status of the current or last test is maintained in upsTestResultsSummary. Tests in progress may be aborted by setting the upsTestId variable to upsTestAbortTestInProgress. Read operations return the value of the name of the test in progress if a test is in progress or the name of the last test performed if no test is in progress, unless no test has been run, in which case the well known value upsTestNoTestsInitiated is returned. |
| upsTestNoTestsInitiated | 1.3.6.1.2.1.33.1.7.7.1 | No tests have been initiated and no test is in progress. | ||
| upsTestQuickBatteryTest | 1.3.6.1.2.1.33.1.7.7.4 | A test that is sufficient to determine if the battery needs replacement. | ||
| STR upsTestResultsDetail | 1.3.6.1.2.1.33.1.7.4 | DisplayString | read-only | Additional information about upsTestResultsSummary. If no additional information available, a zero length string is returned. |
| INT upsTestResultsSummary | 1.3.6.1.2.1.33.1.7.3 | INTEGER | read-only | The results of the current or last UPS diagnostics test performed. The values for donePass(1), doneWarning(2), and doneError(3) indicate that the test completed either successfully, with a warning, or with an error, respectively. The value aborted(4) is returned for tests which are aborted by setting the value of upsTestId to upsTestAbortTestInProgress. Tests which have not yet concluded are indicated by inProgress(5). The value noTestsInitiated(6) indicates that no previous test results are available, such as is the case when no tests have been run since the last reinitialization of the network management subsystem and the system has no provision for non- volatile storage of test results. |
| TES upsTestSpinLock | 1.3.6.1.2.1.33.1.7.2 | TestAndIncr | read-write | A spin lock on the test subsystem. The spinlock is used as follows. Before starting a test, a manager-station should make sure that a test is not in progress as follows: try_again: get (upsTestSpinLock) while (upsTestResultsSummary == inProgress) { /* loop while a test is running for another manager */ short delay get (upsTestSpinLock) } lock_value = upsTestSpinLock /* no test in progress, start the test */ set (upsTestSpinLock = lock_value, upsTestId = requested_test) if (error_index == 1) { /* (upsTestSpinLock failed) */ /* if problem is not access control, then some other manager slipped in ahead of us */ goto try_again } if (error_index == 2) { /* (upsTestId) */ /* cannot perform the test */ give up } /* test started ok */ /* wait for test completion by polling upsTestResultsSummary */ get (upsTestSpinLock, upsTestResultsSummary, upsTestResultsDetail) while (upsTestResultsSummary == inProgress) { short delay get (upsTestSpinLock, upsTestResultsSummary, upsTestResultsDetail) } /* when test completes, retrieve any additional test results */ /* if upsTestSpinLock == lock_value + 1, then these are our test */ /* results (as opposed to another manager's */ The initial value of upsTestSpinLock at agent initialization shall be 1. |
| TIM upsTestStartTime | 1.3.6.1.2.1.33.1.7.5 | TimeStamp | read-only | The value of sysUpTime at the time the test in progress was initiated, or, if no test is in progress, the time the previous test was initiated. If the value of upsTestResultsSummary is noTestsInitiated(6), upsTestStartTime has the value 0. |
| NTF upsTrapAlarmEntryAdded | 1.3.6.1.2.1.33.2.3 | This trap is sent each time an alarm is inserted into to the alarm table. It is sent on the insertion of all alarms except for upsAlarmOnBattery and upsAlarmTestInProgress. | ||
| NTF upsTrapAlarmEntryRemoved | 1.3.6.1.2.1.33.2.4 | This trap is sent each time an alarm is removed from the alarm table. It is sent on the removal of all alarms except for upsAlarmTestInProgress. | ||
| NTF upsTrapOnBattery | 1.3.6.1.2.1.33.2.1 | The UPS is operating on battery power. This trap is persistent and is resent at one minute intervals until the UPS either turns off or is no longer running on battery. | ||
| upsTraps | 1.3.6.1.2.1.33.2 | |||
| NTF upsTrapTestCompleted | 1.3.6.1.2.1.33.2.2 | This trap is sent upon completion of a UPS diagnostic test. | ||
| upsWellKnownAlarms | 1.3.6.1.2.1.33.1.6.3 | |||
| upsWellKnownTests | 1.3.6.1.2.1.33.1.7.7 |
RFC description
Defines managed objects for Uninterruptible Power Supply (UPS) devices including battery status, input/output voltage, load, alarms, and test control as standardized in RFC 1628.
Start monitoring vendor-neutral, standards-based MIB, Uninterruptible Power Supply (UPS) systems (battery health/runtime/alarm status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.