update procstat readme

This commit is contained in:
Ranjib Dey 2015-10-07 00:44:47 -07:00
parent 7391d38ed8
commit 382280870c
1 changed files with 38 additions and 2 deletions

View File

@ -1,7 +1,9 @@
# Procstat plugin # Telegraf plugin: procstat
#### Description
The procstat plugin can be used to monitor system resource usage by an The procstat plugin can be used to monitor system resource usage by an
individual process. individual process using their /proc data.
Processes can be specified either by pid file or by executable name. Procstat Processes can be specified either by pid file or by executable name. Procstat
plugin will use `pgrep` when executable name is provided to obtain the pid. Proctsta 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. plugin will use `pgrep` when executable name is provided to obtain the pid. Proctsta 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.
@ -19,3 +21,37 @@ Example:
pid_file = "/var/run/lxc/dnsmasq.pid" pid_file = "/var/run/lxc/dnsmasq.pid"
prefix = "dnsmasq" prefix = "dnsmasq"
``` ```
# Measurements
Note: prefix will set by the user, per process.
File descriptor related measurement names:
- procstat_prefix_num_fds value=4
Context switch related measurement names:
- procstat_prefix_voluntary_context_switches value=250
- procstat_prefix_involuntary_context_switches value=0
I/O related measurement names:
- 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_user value=0
- procstat_prefix_cpu_system value=0.01
- procstat_prefix_cpu_idle value=0
- procstat_prefix_cpu_nice value=0
- procstat_prefix_cpu_iowait value=0
- procstat_prefix_cpu_irq value=0
- procstat_prefix_cpu_soft_irq value=0
- procstat_prefix_cpu_soft_steal value=0
- procstat_prefix_cpu_soft_stolen value=0
- procstat_prefix_cpu_soft_guest value=0
- procstat_prefix_cpu_soft_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