sysmon/plugins/os-base/README.md

65 lines
2 KiB
Markdown
Raw Normal View History

2021-05-28 13:52:33 +00:00
# Base Plugin
2021-06-14 10:34:30 +00:00
The base plugin uses the [oshi](https://github.com/oshi/oshi) library to get it's metrics.
2021-05-28 13:52:33 +00:00
## Processor Extension
Reports the following metrics seen:
- **system** -CPU time spend on system processes.
2021-06-14 10:34:30 +00:00
- **user** - CPU time spend on user processes.
- **nice** - CPU time spend on user processes running at lower priority.
- **iowait** - CPU time spend waiting (for i/o).
- **steal** - CPU time stolen by hypervisor and given to other virtual systems.
- **irq** - CPU time spend by kernel on interrupt requests.
- **softirq** - CPU time spend by kernel on soft interrupt requests.
- **idle** - CPU time spend idling (doing nothing).
- **busy** - CPU time spend working.
2021-05-28 13:52:33 +00:00
## Memory Extension
2021-06-14 10:34:30 +00:00
Reports the following metrics (in bytes):
2021-05-28 13:52:33 +00:00
2021-06-14 10:34:30 +00:00
- **available** - Estimation of how much memory is available for starting new applications, without swapping.
- **total** - The total amount of (installed) memory.
2021-05-28 13:52:33 +00:00
- **usage** - Percentage of memory used out of the total amount of memory.
2021-06-14 10:34:30 +00:00
- **paged** - ...
- **virtual** - ...
2021-05-28 13:52:33 +00:00
## Disk Extension
Metrics reported are:
2021-06-14 10:34:30 +00:00
- **reads** - The total number of bytes read.
- **writes** - The total number of bytes written.
- **iotime** - Time spent on IO in milliseconds.
2021-09-10 10:15:33 +00:00
- **queue** - Lenght of IO queue.
## Process Extension
Reports metrics on one or more running processes.
- **mem_rss** - Resident set memory in bytes.
- **mem_vsz** - Virtual memory in bytes.
- **kernel_time** - Time spent (in milliseconds) in kernel space.
- **user_time** - Time used (in milliseconds) in user space.
- **read_bytes** - Bytes read by process.
- **write_bytes** - Bytes written by process.
- **files** - Files currently open by process.
- **threads** - Running threads.
- **user** - User running the process.
- **group** - Group running the process
- **prio** - Process priority.
### Configuration
The **include** option let's you specify what processes to report for.
```toml
[extension.base_process]
enabled = true # true or false
include = [ "java", "influxd", "grafana-server" ]
```