telegraf/plugins/inputs/upsd
Paweł Żak e2a510f157
chore: Fix linter findings for errorlint (part7) (#12772)
Co-authored-by: Pawel Zak <Pawel Zak>
2023-03-03 10:11:54 +01:00
..
README.md docs: fix remaining markdownlinter issues (#12658) 2023-02-09 10:57:08 -07:00
sample.conf fix(inputs.upsd): Always convert to float (#12516) 2023-01-26 10:57:23 +01:00
upsd.go chore: Fix linter findings for errorlint (part7) (#12772) 2023-03-03 10:11:54 +01:00
upsd_test.go fix(inputs.upsd): Add additional fields (#12543) 2023-01-31 10:41:58 +01: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.

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 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"

  ## Force parsing numbers as floats
  ## It is highly recommended to enable this setting to parse numbers
  ## consistently as floats to avoid database conflicts where some numbers are
  ## parsed as integers and others as floats.
  # force_float = false

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