Back to the list of connectors

APC UPS

Description

This connector provides hardware monitoring through APC UPS SNMP interface.

Connector ID: APCUPS

This connector supersedes:

Target

Typical platform: APC UPS

Operating system: Out-of-Band

Prerequisites

Leverages: UPS SNMP Enabled

Technology and protocols: SNMP

This connector is not available for the local host (it is applicable to remote hosts only).

Examples

CLI

hws HOSTNAME -t management -f APCUPS --snmp v2c --community public

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: management
  selectedConnectors: [ APCUPS ] # Optional, to load only this connector
  snmp:
    version: v1 # Read documentation for v2 and v3
    community: public # or probably something more secure

Connector Activation Criteria

The APC UPS connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • An SNMP Get on the OID 1.3.6.1.4.1.318.1.1.1.1.1.1.0 must return a value that matches with the UPS regular expression

Metrics

Type Collected Metrics Specific Attributes (Labels)
Enclosure
  • hw.status{hw.type="enclosure",state="ok|degraded|failed"}
  • hw.status{hw.type="enclosure",state="present"}
  • info
  • model
  • serial_number
  • type
  • vendor
Battery
  • hw.battery.charge
  • hw.battery.time_left{state="discharging"}
  • hw.status{hw.type="battery",state="ok|degraded|failed"}
  • hw.status{hw.type="battery",state="present"}
  • model
  • type
  • vendor
Power Supply
  • hw.power_supply.utilization
  • hw.status{hw.type="power_supply",state="present"}
  • power_supply_type
Temperature Sensor
  • hw.status{hw.type="temperature",state="present"}
  • hw.temperature
  • hw.temperature.limit{limit_type="high.critical"}
  • hw.temperature.limit{limit_type="high.degraded"}
  • sensor_location
Voltage Sensor
  • hw.status{hw.type="voltage",state="present"}
  • hw.voltage
  • hw.voltage.limit{limit_type="high.critical"}
  • hw.voltage.limit{limit_type="low.critical"}
  • sensor_location
No results.