linux_cpu

README

Linux CPU Input Plugin

The linux_cpu plugin gathers CPU metrics exposed on Linux-based systems.

Configuration

# Collects CPU metrics exposed on Linux
[[inputs.linux_cpu]]
  ## Path for sysfs filesystem.
  ## See https://www.kernel.org/doc/Documentation/filesystems/sysfs.txt
  ## Defaults:
  # host_sys = "/sys"

  ## CPU metrics collected by the plugin.
  ## Supported options:
  ## "cpufreq", "thermal"
  ## Defaults:
  # metrics = ["cpufreq"]

Metrics

The following tags are emitted by the plugin under the name linux_cpu:

Tag	Description
cpu	Identifier of the CPU

The following fields are emitted by the plugin when selecting cpufreq:

Metric name (field)	Description	Units
scaling_cur_freq	Current frequency of the CPU as determined by CPUFreq	KHz
scaling_min_freq	Minimum frequency the governor can scale to	KHz
scaling_max_freq	Maximum frequency the governor can scale to	KHz
cpuinfo_cur_freq	Current frequency of the CPU as determined by the hardware	KHz
cpuinfo_min_freq	Minimum operating frequency of the CPU	KHz
cpuinfo_max_freq	Maximum operating frequency of the CPU	KHz

The following fields are emitted by the plugin when selecting thermal:

Metric name (field)	Description	Units
throttle_count	Number of thermal throttle events reported by the CPU
throttle_max_time	Maximum amount of time CPU was in throttled state	ms
throtlle_total_time	Cumulative time during which the CPU was in throttled state	ms

Example Output

> linux_cpu,cpu=0,host=go scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=803157i,scaling_min_freq=400000i 1617621150000000000
> linux_cpu,cpu=1,host=go throttle_total_time=0i,scaling_cur_freq=802939i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i 1617621150000000000
> linux_cpu,cpu=10,host=go throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=838343i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i 1617621150000000000
> linux_cpu,cpu=11,host=go cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=800054i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i 1617621150000000000
> linux_cpu,cpu=2,host=go throttle_total_time=0i,scaling_cur_freq=800404i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i 1617621150000000000
> linux_cpu,cpu=3,host=go throttle_total_time=0i,scaling_cur_freq=800126i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i 1617621150000000000
> linux_cpu,cpu=4,host=go cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=800359i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i 1617621150000000000
> linux_cpu,cpu=5,host=go throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=800093i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i 1617621150000000000
> linux_cpu,cpu=6,host=go cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=741646i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i 1617621150000000000
> linux_cpu,cpu=7,host=go scaling_cur_freq=700006i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i 1617621150000000000
> linux_cpu,cpu=8,host=go throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=700046i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i,throttle_count=0i 1617621150000000000
> linux_cpu,cpu=9,host=go throttle_count=0i,throttle_max_time=0i,throttle_total_time=0i,scaling_cur_freq=700075i,scaling_min_freq=400000i,scaling_max_freq=4700000i,cpuinfo_min_freq=400000i,cpuinfo_max_freq=4700000i 1617621150000000000

Documentation

Index

• type LinuxCPU
  • func (g *LinuxCPU) Gather(acc telegraf.Accumulator) error
  • func (g *LinuxCPU) Init() error
  • func (g *LinuxCPU) SampleConfig() string

Types

type LinuxCPU

type LinuxCPU struct {
	Log       telegraf.Logger `toml:"-"`
	PathSysfs string          `toml:"host_sys"`
	Metrics   []string        `toml:"metrics"`
	// contains filtered or unexported fields
}

func (*LinuxCPU) Gather

func (g *LinuxCPU) Gather(acc telegraf.Accumulator) error

func (*LinuxCPU) Init

func (g *LinuxCPU) Init() error

func (*LinuxCPU) SampleConfig

func (g *LinuxCPU) SampleConfig() string