UPSC

Supported OS Linux

Integration version1.0.1

Overview

Get metrics from UPSD service through UPSC in real time to:

  • Visualize and monitor UPS battery health and states
  • Be notified about UPS failovers and events.

Setup

The UPSC check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the UPSC check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

  1. Run the following command to install the Agent integration:

    datadog-agent integration install -t datadog-upsc==<INTEGRATION_VERSION>
    
  2. Configure your integration similar to core integrations.

Configuration

  1. Edit the upsc.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your UPSC metrics. See the sample upsc.d/conf.yaml for all available configuration options.

  2. Restart the Agent

Validation

Run the Agent’s status subcommand and look for upsc under the Checks section.

Data Collected

Metrics

upsc.status
(gauge)
UPS Status
Shown as sample
upsc.battery.charge
(gauge)
UPS Charge
Shown as sample
upsc.battery.charge.low
(gauge)
UPS Charge Low Threshold
Shown as sample
upsc.battery.charge.warning
(gauge)
UPS Charge Warn Threshold
Shown as sample
upsc.battery.runtime
(gauge)
UPS Runtime Remaining
Shown as minute
upsc.battery.runtime.low
(gauge)
UPS Runtime Low Threshold
Shown as minute
upsc.battery.voltage
(gauge)
UPS Battery Voltage
Shown as sample
upsc.battery.voltage.nominal
(gauge)
UPS Battery Nominal Voltage
Shown as sample
upsc.input.voltage
(gauge)
UPS Input Voltage
Shown as sample
upsc.input.voltage.nominal
(gauge)
UPS Input Nominal Voltage
Shown as sample
upsc.output.voltage
(gauge)
UPS Output Voltage
Shown as sample
upsc.load
(gauge)
UPS Load
Shown as sample

Events

The UPSC check does not include any events.

Service Checks

The UPSC check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.