Supported OS Linux

Versión de la integración1.0.1
Esta página aún no está disponible en español. Estamos trabajando en su traducción.
Si tienes alguna pregunta o comentario sobre nuestro actual proyecto de traducción, no dudes en ponerte en contacto con nosotros.

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
upsc.battery.charge
(gauge)
UPS battery charge
Shown as percent
upsc.battery.charge.low
(gauge)
UPS remaining battery level when UPS switches to Low Battery
Shown as percent
upsc.battery.charge.warning
(gauge)
UPS battery level when UPS switches to Warning state
Shown as percent
upsc.battery.runtime
(gauge)
UPS battery runtime
Shown as second
upsc.battery.runtime.low
(gauge)
UPS remaining battery runtime when UPS switches to Low Battery
Shown as second
upsc.battery.voltage
(gauge)
UPS Battery Voltage
Shown as volt
upsc.battery.voltage.nominal
(gauge)
UPS Nominal battery voltage
Shown as volt
upsc.input.voltage
(gauge)
UPS input voltage
Shown as volt
upsc.input.voltage.nominal
(gauge)
UPS nominal input voltage
Shown as volt
upsc.output.voltage
(gauge)
UPS output voltage
Shown as volt
upsc.load
(gauge)
UPS load
Shown as percent

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.