---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from APC UPSD
url: https://docs.influxdata.com/telegraf/v1/input-plugins/apcupsd/
estimated_tokens: 888
product: Telegraf
version: v1
---

-   Telegraf v1.12.0+

# 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
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [APC UPSD Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/apcupsd/README.md)