2022-03-17 00:00:45 +08:00
|
|
|
# Hugepages Input Plugin
|
|
|
|
|
|
2022-06-08 05:37:08 +08:00
|
|
|
Transparent Huge Pages (THP) is a Linux memory management system that reduces
|
|
|
|
|
the overhead of Translation Lookaside Buffer (TLB) lookups on machines with
|
|
|
|
|
large amounts of memory by using larger memory pages.
|
2022-03-17 00:00:45 +08:00
|
|
|
|
2022-08-10 00:57:31 +08:00
|
|
|
Consult [the website][website] for more details.
|
|
|
|
|
|
|
|
|
|
[website]: https://www.kernel.org/doc/html/latest/admin-guide/mm/hugetlbpage.html
|
2022-03-17 00:00:45 +08:00
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
2022-05-24 21:49:47 +08:00
|
|
|
```toml @sample.conf
|
2022-03-17 00:00:45 +08:00
|
|
|
# Gathers huge pages measurements.
|
|
|
|
|
[[inputs.hugepages]]
|
|
|
|
|
## Supported huge page types:
|
2022-08-10 00:57:31 +08:00
|
|
|
## - "root" - based on root huge page control directory:
|
|
|
|
|
## /sys/kernel/mm/hugepages
|
|
|
|
|
## - "per_node" - based on per NUMA node directories:
|
|
|
|
|
## /sys/devices/system/node/node[0-9]*/hugepages
|
|
|
|
|
## - "meminfo" - based on /proc/meminfo file
|
2022-03-17 00:00:45 +08:00
|
|
|
# types = ["root", "per_node"]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Measurements
|
|
|
|
|
|
|
|
|
|
**The following measurements are supported by Hugepages plugin:**
|
|
|
|
|
|
2022-08-10 00:57:31 +08:00
|
|
|
- hugepages_root (gathered from `/sys/kernel/mm/hugepages`)
|
2022-03-17 00:00:45 +08:00
|
|
|
- tags:
|
|
|
|
|
- size_kb (integer, kB)
|
|
|
|
|
- fields:
|
|
|
|
|
- free (integer)
|
|
|
|
|
- mempolicy (integer)
|
|
|
|
|
- overcommit (integer)
|
|
|
|
|
- reserved (integer)
|
|
|
|
|
- surplus (integer)
|
|
|
|
|
- total (integer)
|
2022-08-10 00:57:31 +08:00
|
|
|
- hugepages_per_node (gathered from `/sys/devices/system/node/node[0-9]*/hugepages`)
|
2022-03-17 00:00:45 +08:00
|
|
|
- tags:
|
|
|
|
|
- size_kb (integer, kB)
|
|
|
|
|
- node (integer)
|
|
|
|
|
- fields:
|
|
|
|
|
- free (integer)
|
|
|
|
|
- surplus (integer)
|
|
|
|
|
- total (integer)
|
|
|
|
|
- hugepages_meminfo (gathered from `/proc/meminfo` file)
|
2022-08-10 00:57:31 +08:00
|
|
|
- The fields `total`, `free`, `reserved`, and `surplus` are counts of pages
|
|
|
|
|
of default size. Fields with suffix `_kb` are in kilobytes.
|
2022-03-17 00:00:45 +08:00
|
|
|
- fields:
|
|
|
|
|
- anonymous_kb (integer, kB)
|
|
|
|
|
- file_kb (integer, kB)
|
|
|
|
|
- free (integer)
|
|
|
|
|
- reserved (integer)
|
|
|
|
|
- shared_kb (integer, kB)
|
|
|
|
|
- size_kb (integer, kB)
|
|
|
|
|
- surplus (integer)
|
|
|
|
|
- tlb_kb (integer, kB)
|
|
|
|
|
- total (integer)
|
|
|
|
|
|
|
|
|
|
## Example Output
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
$ ./telegraf -config telegraf.conf -input-filter hugepages -test
|
|
|
|
|
> hugepages_root,host=ubuntu,size_kb=1048576 free=0i,mempolicy=8i,overcommit=0i,reserved=0i,surplus=0i,total=8i 1646258020000000000
|
|
|
|
|
> hugepages_root,host=ubuntu,size_kb=2048 free=883i,mempolicy=2048i,overcommit=0i,reserved=0i,surplus=0i,total=2048i 1646258020000000000
|
|
|
|
|
> hugepages_per_node,host=ubuntu,size_kb=1048576,node=0 free=0i,surplus=0i,total=4i 1646258020000000000
|
|
|
|
|
> hugepages_per_node,host=ubuntu,size_kb=2048,node=0 free=434i,surplus=0i,total=1024i 1646258020000000000
|
|
|
|
|
> hugepages_per_node,host=ubuntu,size_kb=1048576,node=1 free=0i,surplus=0i,total=4i 1646258020000000000
|
|
|
|
|
> hugepages_per_node,host=ubuntu,size_kb=2048,node=1 free=449i,surplus=0i,total=1024i 1646258020000000000
|
|
|
|
|
> hugepages_meminfo,host=ubuntu anonymous_kb=0i,file_kb=0i,free=883i,reserved=0i,shared_kb=0i,size_kb=2048i,surplus=0i,tlb_kb=12582912i,total=2048i 1646258020000000000
|
|
|
|
|
```
|
