---
title: ''
description: Telegraf plugin for collecting metrics from APC UPSD
url: https://docs.influxdata.com/telegraf/v1/input-plugins/apcupsd/
estimated_tokens: 523
product: Telegraf Controller
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/apcupsd/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.12.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.0/plugins/inputs/apcupsd/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.0/plugins/inputs/apcupsd/sample.conf)

# APC UPSD Input Plugin

This plugin gathers data from one or more [apcupsd daemon](https://sourceforge.net/projects/apcupsd/) over
the NIS network protocol. To query a server, the daemon must be running and be
accessible.

**Introduced in:** Telegraf v1.12.0**Tags:** hardware, server**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Monitor APC UPSes connected to apcupsd
[[inputs.apcupsd]]
  # A list of running apcupsd server to connect to.
  # If not provided will default to tcp://127.0.0.1:3551
  servers = ["tcp://127.0.0.1:3551"]

  ## Timeout for dialing server.
  timeout = "5s"
```

## Metrics

* apcupsd
  * tags:
    * serial
    * ups\_name
    * status (string representing the set status\_flags)
    * model

  * fields:
    * status\_flags ([status-bits](http://www.apcupsd.org/manual/manual.html#status-bits))
    * input\_voltage
    * load\_percent
    * battery\_charge\_percent
    * time\_left\_ns
    * output\_voltage
    * internal\_temp
    * battery\_voltage
    * input\_frequency
    * time\_on\_battery\_ns
    * cumulative\_time\_on\_battery\_ns
    * nominal\_input\_voltage
    * nominal\_battery\_voltage
    * nominal\_power
    * firmware
    * battery\_date
    * last\_transfer
    * number\_transfers

## Example Output

```text
apcupsd,serial=AS1231515,status=ONLINE,ups_name=name1 time_on_battery=0,load_percent=9.7,time_left_minutes=98,output_voltage=230.4,internal_temp=32.4,battery_voltage=27.4,input_frequency=50.2,input_voltage=230.4,battery_charge_percent=100,status_flags=8i 1490035922000000000
```