dd537b3382
Many of the examples provided within documentation are using a single dash for the command line arguments, but the telegraf executable explicitly has two dashes. There are also some inconsistencies with the ordering of the command line argument examples. I've ordered them so that the examples will show: config, config-directory, input-filter, test
65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
# Kernel Input Plugin
|
|
|
|
This plugin is only available on Linux.
|
|
|
|
The kernel plugin gathers info about the kernel that doesn't fit into other
|
|
plugins. In general, it is the statistics available in `/proc/stat` that are
|
|
not covered by other plugins.
|
|
|
|
The metrics are documented in `man proc` under the `/proc/stat` section.
|
|
|
|
```
|
|
/proc/stat
|
|
kernel/system statistics. Varies with architecture. Common entries include:
|
|
|
|
page 5741 1808
|
|
The number of pages the system paged in and the number that were paged out (from disk).
|
|
|
|
swap 1 0
|
|
The number of swap pages that have been brought in and out.
|
|
|
|
intr 1462898
|
|
This line shows counts of interrupts serviced since boot time, for each of
|
|
the possible system interrupts. The first column is the total of all
|
|
interrupts serviced; each subsequent column is the total for a particular interrupt.
|
|
|
|
ctxt 115315
|
|
The number of context switches that the system underwent.
|
|
|
|
btime 769041601
|
|
boot time, in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
|
|
|
|
processes 86031
|
|
Number of forks since boot.
|
|
```
|
|
|
|
### Configuration:
|
|
|
|
```toml
|
|
# Get kernel statistics from /proc/stat
|
|
[[inputs.kernel]]
|
|
# no configuration
|
|
```
|
|
|
|
### Measurements & Fields:
|
|
|
|
- kernel
|
|
- boot_time (integer, seconds since epoch, `btime`)
|
|
- context_switches (integer, `ctxt`)
|
|
- disk_pages_in (integer, `page (0)`)
|
|
- disk_pages_out (integer, `page (1)`)
|
|
- interrupts (integer, `intr`)
|
|
- processes_forked (integer, `processes`)
|
|
|
|
### Tags:
|
|
|
|
None
|
|
|
|
### Example Output:
|
|
|
|
```
|
|
$ telegraf --config ~/ws/telegraf.conf --input-filter kernel --test
|
|
* Plugin: kernel, Collection 1
|
|
> kernel boot_time=1457505775i,context_switches=2626618i,disk_pages_in=5741i,disk_pages_out=1808i,interrupts=1472736i,processes_forked=10673i 1457613402960879816
|
|
```
|