procstat

package
v0.0.0-...-3667945 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 26, 2019 License: MIT Imports: 12 Imported by: 0

README

Telegraf plugin: procstat

Description

The procstat plugin can be used to monitor system resource usage by an individual process using their /proc data.

Processes can be specified either by pid file, by executable name, by command line pattern matching, by username, by systemd unit name, or by cgroup name/path (in this order or priority). Procstat plugin will use pgrep when executable name is provided to obtain the pid. Procstat plugin will transmit IO, memory, cpu, file descriptor related measurements for every process specified. A prefix can be set to isolate individual process specific measurements.

The plugin will tag processes according to how they are specified in the configuration. If a pid file is used, a "pidfile" tag will be generated. On the other hand, if an executable is used an "exe" tag will be generated. Possible tag names:

  • pidfile
  • exe
  • pattern
  • user
  • systemd_unit
  • cgroup

Additionally the plugin will tag processes by their PID (pid_tag = true in the config) and their process name:

  • pid
  • process_name

Example:

[[inputs.procstat]]
  exe = "influxd"
  prefix = "influxd"

[[inputs.procstat]]
  pid_file = "/var/run/lxc/dnsmasq.pid"

The above configuration would result in output like:

> procstat,pidfile=/var/run/lxc/dnsmasq.pid,process_name=dnsmasq rlimit_file_locks_soft=2147483647i,rlimit_signals_pending_hard=1758i,voluntary_context_switches=478i,read_bytes=307200i,cpu_time_user=0.01,cpu_time_guest=0,memory_swap=0i,memory_locked=0i,rlimit_num_fds_hard=4096i,rlimit_nice_priority_hard=0i,num_fds=11i,involuntary_context_switches=20i,read_count=23i,memory_rss=1388544i,rlimit_memory_rss_soft=2147483647i,rlimit_memory_rss_hard=2147483647i,nice_priority=20i,rlimit_cpu_time_hard=2147483647i,cpu_time=0i,write_bytes=0i,cpu_time_idle=0,cpu_time_nice=0,memory_data=229376i,memory_stack=135168i,rlimit_cpu_time_soft=2147483647i,rlimit_memory_data_hard=2147483647i,rlimit_memory_locked_hard=65536i,rlimit_signals_pending_soft=1758i,write_count=11i,cpu_time_iowait=0,cpu_time_steal=0,cpu_time_stolen=0,rlimit_memory_stack_soft=8388608i,cpu_time_system=0.02,cpu_time_guest_nice=0,rlimit_memory_locked_soft=65536i,rlimit_memory_vms_soft=2147483647i,rlimit_file_locks_hard=2147483647i,rlimit_realtime_priority_hard=0i,pid=828i,num_threads=1i,cpu_time_soft_irq=0,rlimit_memory_vms_hard=2147483647i,rlimit_realtime_priority_soft=0i,memory_vms=15884288i,rlimit_memory_stack_hard=2147483647i,cpu_time_irq=0,rlimit_memory_data_soft=2147483647i,rlimit_num_fds_soft=1024i,signals_pending=0i,rlimit_nice_priority_soft=0i,realtime_priority=0i
> procstat,exe=influxd,process_name=influxd rlimit_num_fds_hard=16384i,rlimit_signals_pending_hard=1758i,realtime_priority=0i,rlimit_memory_vms_hard=2147483647i,rlimit_signals_pending_soft=1758i,cpu_time_stolen=0,rlimit_memory_stack_hard=2147483647i,rlimit_realtime_priority_hard=0i,cpu_time=0i,pid=500i,voluntary_context_switches=975i,cpu_time_idle=0,memory_rss=3072000i,memory_locked=0i,rlimit_nice_priority_soft=0i,signals_pending=0i,nice_priority=20i,read_bytes=823296i,cpu_time_soft_irq=0,rlimit_memory_data_hard=2147483647i,rlimit_memory_locked_soft=65536i,write_count=8i,cpu_time_irq=0,memory_vms=33501184i,rlimit_memory_stack_soft=8388608i,cpu_time_iowait=0,rlimit_memory_vms_soft=2147483647i,rlimit_nice_priority_hard=0i,num_fds=29i,memory_data=229376i,rlimit_cpu_time_soft=2147483647i,rlimit_file_locks_soft=2147483647i,num_threads=1i,write_bytes=0i,cpu_time_steal=0,rlimit_memory_rss_hard=2147483647i,cpu_time_guest=0,cpu_time_guest_nice=0,cpu_usage=0,rlimit_memory_locked_hard=65536i,rlimit_file_locks_hard=2147483647i,involuntary_context_switches=38i,read_count=16851i,memory_swap=0i,rlimit_memory_data_soft=2147483647i,cpu_time_user=0.11,rlimit_cpu_time_hard=2147483647i,rlimit_num_fds_soft=16384i,rlimit_realtime_priority_soft=0i,cpu_time_system=0.27,cpu_time_nice=0,memory_stack=135168i,rlimit_memory_rss_soft=2147483647i

Measurements

Note: prefix can be set by the user, per process.

Threads related measurement names:

  • procstat_[prefix_]num_threads value=5

File descriptor related measurement names (telegraf needs to run as root):

  • procstat_[prefix_]num_fds value=4

Priority related measurement names:

  • procstat_[prefix_]realtime_priority value=0
  • procstat_[prefix_]nice_priority value=20

Signals related measurement names:

  • procstat_[prefix_]signals_pending value=0

Context switch related measurement names:

  • procstat_[prefix_]voluntary_context_switches value=250
  • procstat_[prefix_]involuntary_context_switches value=0

I/O related measurement names (telegraf needs to run as root):

  • procstat_[prefix_]read_count value=396
  • procstat_[prefix_]write_count value=1
  • procstat_[prefix_]read_bytes value=1019904
  • procstat_[prefix_]write_bytes value=1

CPU related measurement names:

  • procstat_[prefix_]cpu_time value=0.01
  • procstat_[prefix_]cpu_time_user value=0
  • procstat_[prefix_]cpu_time_system value=0.01
  • procstat_[prefix_]cpu_time_idle value=0
  • procstat_[prefix_]cpu_time_nice value=0
  • procstat_[prefix_]cpu_time_iowait value=0
  • procstat_[prefix_]cpu_time_irq value=0
  • procstat_[prefix_]cpu_time_soft_irq value=0
  • procstat_[prefix_]cpu_time_steal value=0
  • procstat_[prefix_]cpu_time_stolen value=0
  • procstat_[prefix_]cpu_time_guest value=0
  • procstat_[prefix_]cpu_time_guest_nice value=0

Memory related measurement names:

  • procstat_[prefix_]memory_rss value=1777664
  • procstat_[prefix_]memory_vms value=24227840
  • procstat_[prefix_]memory_swap value=282624
  • procstat_[prefix_]memory_data value=229376
  • procstat_[prefix_]memory_stack value=135168
  • procstat_[prefix_]memory_locked value=0

Resource limits:

  • procstat_[prefix_]rlimit_cpu_time_hard value=2147483647
  • procstat_[prefix_]rlimit_cpu_time_soft value=2147483647
  • procstat_[prefix_]rlimit_file_locks_hard value=2147483647
  • procstat_[prefix_]rlimit_file_locks_soft value=2147483647
  • procstat_[prefix_]rlimit_memory_data_hard value=2147483647
  • procstat_[prefix_]rlimit_memory_data_soft value=2147483647
  • procstat_[prefix_]rlimit_memory_locked_hard value=65536
  • procstat_[prefix_]rlimit_memory_locked_soft value=65536
  • procstat_[prefix_]rlimit_memory_rss_hard value=2147483647
  • procstat_[prefix_]rlimit_memory_rss_soft value=2147483647
  • procstat_[prefix_]rlimit_memory_stack_hard value=2147483647
  • procstat_[prefix_]rlimit_memory_stack_soft value=8388608
  • procstat_[prefix_]rlimit_memory_vms_hard value=2147483647
  • procstat_[prefix_]rlimit_memory_vms_soft value=2147483647
  • procstat_[prefix_]rlimit_nice_priority_hard value=0
  • procstat_[prefix_]rlimit_nice_priority_soft value=0
  • procstat_[prefix_]rlimit_num_fds_hard value=16384
  • procstat_[prefix_]rlimit_num_fds_soft value=16384
  • procstat_[prefix_]rlimit_realtime_priority_hard value=0
  • procstat_[prefix_]rlimit_realtime_priority_soft value=0
  • procstat_[prefix_]rlimit_signals_pending_hard value=1758
  • procstat_[prefix_]rlimit_signals_pending_soft value=1758

NOTE: Due to a limitation in an underlying library Telegraf uses, any resource limit > 2147483647 will be misreported as 2147483647.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type PID 

type PID int32

type PIDFinder 

type PIDFinder interface {
	PidFile(path string) ([]PID, error)
	Pattern(pattern string) ([]PID, error)
	Uid(user string) ([]PID, error)
	FullPattern(path string) ([]PID, error)
}

func NewPgrep 

func NewPgrep() (PIDFinder, error)

type Pgrep 

type Pgrep struct {
	// contains filtered or unexported fields
}

Implemention of PIDGatherer that execs pgrep to find processes

func (*Pgrep) FullPattern 

func (pg *Pgrep) FullPattern(pattern string) ([]PID, error)

func (*Pgrep) Pattern 

func (pg *Pgrep) Pattern(pattern string) ([]PID, error)

func (*Pgrep) PidFile 

func (pg *Pgrep) PidFile(path string) ([]PID, error)

func (*Pgrep) Uid 

func (pg *Pgrep) Uid(user string) ([]PID, error)

type Proc 

type Proc struct {
	*process.Process
	// contains filtered or unexported fields
}

func (*Proc) PID 

func (p *Proc) PID() PID

func (*Proc) Percent 

func (p *Proc) Percent(interval time.Duration) (float64, error)

func (*Proc) Tags 

func (p *Proc) Tags() map[string]string

type Process 

type Process interface {
	PID() PID
	Tags() map[string]string

	IOCounters() (*process.IOCountersStat, error)
	MemoryInfo() (*process.MemoryInfoStat, error)
	Name() (string, error)
	NumCtxSwitches() (*process.NumCtxSwitchesStat, error)
	NumFDs() (int32, error)
	NumThreads() (int32, error)
	Percent(interval time.Duration) (float64, error)
	Times() (*cpu.TimesStat, error)
	RlimitUsage(bool) ([]process.RlimitStat, error)
}

func NewProc 

func NewProc(pid PID) (Process, error)

type Procstat 

type Procstat struct {
	PidFile     string `toml:"pid_file"`
	Exe         string
	Pattern     string
	Prefix      string
	ProcessName string
	User        string
	SystemdUnit string
	CGroup      string `toml:"cgroup"`
	PidTag      bool
	// contains filtered or unexported fields
}

func (*Procstat) Description 

func (_ *Procstat) Description() string

func (*Procstat) Gather 

func (p *Procstat) Gather(acc telegraf.Accumulator) error

func (*Procstat) SampleConfig 

func (_ *Procstat) SampleConfig() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.