upsd

README

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

Documentation

Index

• type Upsd
  • func (u *Upsd) Gather(acc telegraf.Accumulator) error
  • func (*Upsd) SampleConfig() string

Types

type Upsd

type Upsd struct {
	Server   string
	Port     int
	Username string
	Password string
	Log      telegraf.Logger `toml:"-"`
	// contains filtered or unexported fields
}

func (*Upsd) Gather

func (u *Upsd) Gather(acc telegraf.Accumulator) error

func (*Upsd) SampleConfig

func (*Upsd) SampleConfig() string