telegraf/plugins/inputs/apcupsd
Paweł Żak 9bf9fb3a4d
chore(linters): Enable `usetesting` linter (#16456)
Co-authored-by: pzak <pzak>
Co-authored-by: Zak <pawel.zak@intel.com>
2025-03-10 02:12:42 -05:00
..
README.md docs(inputs): Add plugin metadata and update description for a* to f* (#16097) 2024-10-31 16:15:21 -05:00
apcupsd.go chore(linters): Enable `import-alias-naming` and `redundant-import-alias` rules for revive (#15836) 2024-10-01 13:49:53 -05:00
apcupsd_test.go chore(linters): Enable `usetesting` linter (#16456) 2025-03-10 02:12:42 -05:00
sample.conf chore(inputs_a-l): migrate sample configs into separate files (#11132) 2022-05-18 11:31:52 -05:00

README.md

APC UPSD Input Plugin

This plugin gathers data from one or more apcupsd daemon over the NIS network protocol. To query a server, the daemon must be running and be accessible.

Telegraf v1.12.0 🏷️ hardware, server 💻 all

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# 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)
      • 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

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