telegraf/plugins/inputs/upsd
Sebastian Spaink d67f75e557
docs: Remove warning not to remove go:embed (#11797)
Co-authored-by: Joshua Powers <powersj@fastmail.com>
2022-09-13 12:47:58 -05:00
..
README.md fix(inputs.upsd): Move to new sample.conf style (#11471) 2022-07-08 08:47:58 -05:00
sample.conf fix(inputs.upsd): Move to new sample.conf style (#11471) 2022-07-08 08:47:58 -05:00
upsd.go docs: Remove warning not to remove go:embed (#11797) 2022-09-13 12:47:58 -05:00
upsd_test.go feat(input): add upsd implementation (#9890) 2022-07-06 13:09:18 -06:00

README.md

UPSD Input Plugin

This plugin reads data of one or more Uninterruptible Power Supplies from an upsd daemon using its NUT network protocol.

Requirements

upsd should be installed and it's daemon should be running.

Configuration

# Monitor UPSes connected via Network UPS Tools
[[inputs.upsd]]
  ## A running NUT server to connect to.
  # server = "127.0.0.1"
  # port = 3493
  # username = "user"
  # password = "password"

Metrics

This implementation tries to maintain compatibility with the apcupsd metrics:

  • upsd
    • tags:
      • serial
      • ups_name
      • model
    • fields:
      • status_flags ([status-bits][])
      • input_voltage
      • load_percent
      • battery_charge_percent
      • time_left_ns
      • output_voltage
      • internal_temp
      • battery_voltage
      • input_frequency
      • battery_date
      • nominal_input_voltage
      • nominal_battery_voltage
      • nominal_power
      • firmware

With the exception of:

  • tags:
    • status (string representing the set status_flags)
  • fields:
    • time_on_battery_ns

Example Output

upsd,serial=AS1231515,ups_name=name1 load_percent=9.7,time_left_ns=9800000,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