sensors

README

sensors Input Plugin

Collect lm-sensors metrics - requires the lm-sensors package installed.

This plugin collects sensor metrics with the sensors executable from the lm-sensor package.

Configuration:

# Monitor sensors, requires lm-sensors package
[[inputs.sensors]]
  ## Remove numbers from field names.
  ## If true, a field name like 'temp1_input' will be changed to 'temp_input'.
  # remove_numbers = true

  ## Timeout is the maximum amount of time that the sensors command can run.
  # timeout = "5s"

Measurements & Fields:

Fields are created dynamically depending on the sensors. All fields are float.

Tags:

• All measurements have the following tags:
  • chip
  • feature

Example Output:

Default

$ telegraf --config telegraf.conf --input-filter sensors --test
* Plugin: sensors, Collection 1
> sensors,chip=power_meter-acpi-0,feature=power1 power_average=0,power_average_interval=300 1466751326000000000
> sensors,chip=k10temp-pci-00c3,feature=temp1 temp_crit=70,temp_crit_hyst=65,temp_input=29,temp_max=70 1466751326000000000
> sensors,chip=k10temp-pci-00cb,feature=temp1 temp_input=29,temp_max=70 1466751326000000000
> sensors,chip=k10temp-pci-00d3,feature=temp1 temp_input=27.5,temp_max=70 1466751326000000000
> sensors,chip=k10temp-pci-00db,feature=temp1 temp_crit=70,temp_crit_hyst=65,temp_input=29.5,temp_max=70 1466751326000000000

With remove_numbers=false

* Plugin: sensors, Collection 1
> sensors,chip=power_meter-acpi-0,feature=power1 power1_average=0,power1_average_interval=300 1466753424000000000
> sensors,chip=k10temp-pci-00c3,feature=temp1 temp1_crit=70,temp1_crit_hyst=65,temp1_input=29.125,temp1_max=70 1466753424000000000
> sensors,chip=k10temp-pci-00cb,feature=temp1 temp1_input=29,temp1_max=70 1466753424000000000
> sensors,chip=k10temp-pci-00d3,feature=temp1 temp1_input=29.5,temp1_max=70 1466753424000000000
> sensors,chip=k10temp-pci-00db,feature=temp1 temp1_crit=70,temp1_crit_hyst=65,temp1_input=30,temp1_max=70 1466753424000000000

Documentation

Index

• type Sensors
  • func (*Sensors) Description() string
  • func (s *Sensors) Gather(acc telegraf.Accumulator) error
  • func (*Sensors) SampleConfig() string

Types

type Sensors

type Sensors struct {
	RemoveNumbers bool              `toml:"remove_numbers"`
	Timeout       internal.Duration `toml:"timeout"`
	// contains filtered or unexported fields
}

func (*Sensors) Description

func (*Sensors) Description() string

func (*Sensors) Gather

func (s *Sensors) Gather(acc telegraf.Accumulator) error

func (*Sensors) SampleConfig

func (*Sensors) SampleConfig() string