171 lines
5.5 KiB
Markdown
171 lines
5.5 KiB
Markdown
# Procstat Input Plugin
|
|
|
|
The procstat plugin can be used to monitor the system resource usage of one or more processes.
|
|
The procstat_lookup metric displays the query information,
|
|
specifically the number of PIDs returned on a search
|
|
|
|
Processes can be selected for monitoring using one of several methods:
|
|
- pidfile
|
|
- exe
|
|
- pattern
|
|
- user
|
|
- systemd_unit
|
|
- cgroup
|
|
- win_service
|
|
|
|
### Configuration:
|
|
|
|
```toml
|
|
# Monitor process cpu and memory usage
|
|
[[inputs.procstat]]
|
|
## PID file to monitor process
|
|
pid_file = "/var/run/nginx.pid"
|
|
## executable name (ie, pgrep <exe>)
|
|
# exe = "nginx"
|
|
## pattern as argument for pgrep (ie, pgrep -f <pattern>)
|
|
# pattern = "nginx"
|
|
## user as argument for pgrep (ie, pgrep -u <user>)
|
|
# user = "nginx"
|
|
## Systemd unit name
|
|
# systemd_unit = "nginx.service"
|
|
## CGroup name or path
|
|
# cgroup = "systemd/system.slice/nginx.service"
|
|
|
|
## Windows service name
|
|
# win_service = ""
|
|
|
|
## override for process_name
|
|
## This is optional; default is sourced from /proc/<pid>/status
|
|
# process_name = "bar"
|
|
|
|
## Field name prefix
|
|
# prefix = ""
|
|
|
|
## When true add the full cmdline as a tag.
|
|
# cmdline_tag = false
|
|
|
|
## Add PID as a tag instead of a field; useful to differentiate between
|
|
## processes whose tags are otherwise the same. Can create a large number
|
|
## of series, use judiciously.
|
|
# pid_tag = false
|
|
|
|
## Method to use when finding process IDs. Can be one of 'pgrep', or
|
|
## 'native'. The pgrep finder calls the pgrep executable in the PATH while
|
|
## the native finder performs the search directly in a manor dependent on the
|
|
## platform. Default is 'pgrep'
|
|
# pid_finder = "pgrep"
|
|
```
|
|
|
|
#### Windows support
|
|
|
|
Preliminary support for Windows has been added, however you may prefer using
|
|
the `win_perf_counters` input plugin as a more mature alternative.
|
|
|
|
When using the `pid_finder = "native"` in Windows, the pattern lookup method is
|
|
implemented as a WMI query. The pattern allows fuzzy matching using only
|
|
[WMI query patterns](https://msdn.microsoft.com/en-us/library/aa392263(v=vs.85).aspx):
|
|
```toml
|
|
[[inputs.procstat]]
|
|
pattern = "%influx%"
|
|
pid_finder = "native"
|
|
```
|
|
|
|
### Metrics:
|
|
|
|
- procstat
|
|
- tags:
|
|
- pid (when `pid_tag` is true)
|
|
- cmdline (when 'cmdline_tag' is true)
|
|
- process_name
|
|
- pidfile (when defined)
|
|
- exe (when defined)
|
|
- pattern (when defined)
|
|
- user (when selected)
|
|
- systemd_unit (when defined)
|
|
- cgroup (when defined)
|
|
- win_service (when defined)
|
|
- fields:
|
|
- child_major_faults (int)
|
|
- child_minor_faults (int)
|
|
- created_at (int) [epoch in nanoseconds]
|
|
- cpu_time (int)
|
|
- cpu_time_guest (float)
|
|
- cpu_time_guest_nice (float)
|
|
- cpu_time_idle (float)
|
|
- cpu_time_iowait (float)
|
|
- cpu_time_irq (float)
|
|
- cpu_time_nice (float)
|
|
- cpu_time_soft_irq (float)
|
|
- cpu_time_steal (float)
|
|
- cpu_time_system (float)
|
|
- cpu_time_user (float)
|
|
- cpu_usage (float)
|
|
- involuntary_context_switches (int)
|
|
- major_faults (int)
|
|
- memory_data (int)
|
|
- memory_locked (int)
|
|
- memory_rss (int)
|
|
- memory_stack (int)
|
|
- memory_swap (int)
|
|
- memory_usage (float)
|
|
- memory_vms (int)
|
|
- minor_faults (int)
|
|
- nice_priority (int)
|
|
- num_fds (int, *telegraf* may need to be ran as **root**)
|
|
- num_threads (int)
|
|
- pid (int)
|
|
- read_bytes (int, *telegraf* may need to be ran as **root**)
|
|
- read_count (int, *telegraf* may need to be ran as **root**)
|
|
- realtime_priority (int)
|
|
- rlimit_cpu_time_hard (int)
|
|
- rlimit_cpu_time_soft (int)
|
|
- rlimit_file_locks_hard (int)
|
|
- rlimit_file_locks_soft (int)
|
|
- rlimit_memory_data_hard (int)
|
|
- rlimit_memory_data_soft (int)
|
|
- rlimit_memory_locked_hard (int)
|
|
- rlimit_memory_locked_soft (int)
|
|
- rlimit_memory_rss_hard (int)
|
|
- rlimit_memory_rss_soft (int)
|
|
- rlimit_memory_stack_hard (int)
|
|
- rlimit_memory_stack_soft (int)
|
|
- rlimit_memory_vms_hard (int)
|
|
- rlimit_memory_vms_soft (int)
|
|
- rlimit_nice_priority_hard (int)
|
|
- rlimit_nice_priority_soft (int)
|
|
- rlimit_num_fds_hard (int)
|
|
- rlimit_num_fds_soft (int)
|
|
- rlimit_realtime_priority_hard (int)
|
|
- rlimit_realtime_priority_soft (int)
|
|
- rlimit_signals_pending_hard (int)
|
|
- rlimit_signals_pending_soft (int)
|
|
- signals_pending (int)
|
|
- voluntary_context_switches (int)
|
|
- write_bytes (int, *telegraf* may need to be ran as **root**)
|
|
- write_count (int, *telegraf* may need to be ran as **root**)
|
|
- procstat_lookup
|
|
- tags:
|
|
- exe
|
|
- pid_finder
|
|
- pid_file
|
|
- pattern
|
|
- prefix
|
|
- user
|
|
- systemd_unit
|
|
- cgroup
|
|
- win_service
|
|
- result
|
|
- fields:
|
|
- pid_count (int)
|
|
- running (int)
|
|
- result_code (int, success = 0, lookup_error = 1)
|
|
|
|
*NOTE: Resource limit > 2147483647 will be reported as 2147483647.*
|
|
|
|
### Example Output:
|
|
|
|
```
|
|
procstat_lookup,host=prash-laptop,pattern=influxd,pid_finder=pgrep,result=success pid_count=1i,running=1i,result_code=0i 1582089700000000000
|
|
procstat,host=prash-laptop,pattern=influxd,process_name=influxd,user=root involuntary_context_switches=151496i,child_minor_faults=1061i,child_major_faults=8i,cpu_time_user=2564.81,cpu_time_idle=0,cpu_time_irq=0,cpu_time_guest=0,pid=32025i,major_faults=8609i,created_at=1580107536000000000i,voluntary_context_switches=1058996i,cpu_time_system=616.98,cpu_time_steal=0,cpu_time_guest_nice=0,memory_swap=0i,memory_locked=0i,memory_usage=1.7797634601593018,num_threads=18i,cpu_time_nice=0,cpu_time_iowait=0,cpu_time_soft_irq=0,memory_rss=148643840i,memory_vms=1435688960i,memory_data=0i,memory_stack=0i,minor_faults=1856550i 1582089700000000000
|
|
```
|