telegraf/plugins/inputs/ipvs/README.md

29 lines
1.1 KiB
Markdown
Raw Normal View History

2018-10-25 19:44:43 +00:00
# IPVS Input Plugin
2018-10-25 19:14:19 +00:00
The IPVS input plugin uses the linux kernel netlink socket interface to gather
metrics about ipvs virtual and real servers.
2018-10-25 19:44:43 +00:00
**Supported Platforms:** Linux
2018-10-25 19:14:19 +00:00
2018-10-25 19:44:43 +00:00
### Configuration:
```toml
2018-10-25 19:14:19 +00:00
[[inputs.ipvs]]
# no configuration
2018-10-25 19:44:43 +00:00
```
2018-10-25 19:14:19 +00:00
2018-10-25 19:44:43 +00:00
### Permissions:
2018-10-25 19:14:19 +00:00
Assuming you installed the telegraf package via one of the published packages,
the process will be running as the `telegraf` user. However, in order for this
plugin to communicate over netlink sockets it needs the telegraf process to be
running as `root` (or some user with `CAP_NET_ADMIN` and `CAP_NET_RAW`). Be sure
to ensure these permissions before running telegraf with this plugin included.
2018-10-25 19:44:43 +00:00
### Example Output:
2018-10-25 19:14:19 +00:00
```
ipvs_virtual_server,address=172.18.64.234,address_family=inet,netmask=32,port=9000,protocol=tcp,sched=mh_418 bytes_out=0i,pps_in=0i,pps_out=0i,cps=0i,pkts_in=0i,pkts_out=0i,connections=0i,bytes_in=0i 1540407540000000000
ipvs_virtual_server,address_family=inet,fwmark=47,netmask=32,sched=mh_418 connections=0i,pkts_in=0i,bytes_out=0i,pps_in=0i,pps_out=0i,pkts_out=0i,bytes_in=0i,cps=0i 1540407540000000000
```