157 lines
5.4 KiB
Markdown
157 lines
5.4 KiB
Markdown
# Docker Input Plugin
|
|
|
|
The docker plugin uses the docker remote API to gather metrics on running
|
|
docker containers. You can read Docker's documentation for their remote API
|
|
[here](https://docs.docker.com/engine/reference/api/docker_remote_api_v1.20/#get-container-stats-based-on-resource-usage)
|
|
|
|
The docker plugin uses the excellent
|
|
[fsouza go-dockerclient](https://github.com/fsouza/go-dockerclient) library to
|
|
gather stats. Documentation for the library can be found
|
|
[here](https://godoc.org/github.com/fsouza/go-dockerclient) and documentation
|
|
for the stat structure can be found
|
|
[here](https://godoc.org/github.com/fsouza/go-dockerclient#Stats)
|
|
|
|
### Configuration:
|
|
|
|
```
|
|
# Read metrics about docker containers
|
|
[[inputs.docker]]
|
|
# Docker Endpoint
|
|
# To use TCP, set endpoint = "tcp://[ip]:[port]"
|
|
# To use environment variables (ie, docker-machine), set endpoint = "ENV"
|
|
endpoint = "unix:///var/run/docker.sock"
|
|
# Only collect metrics for these containers, collect all if empty
|
|
container_names = []
|
|
calculate_percentages = false
|
|
```
|
|
|
|
### Calculate Percentages
|
|
|
|
Optionally percentages can be calculated for cpu and memory usage. This uses
|
|
the same calculation as the 'docker stats' command line tool. Set this option
|
|
to 'true' to enable this feature.
|
|
|
|
|
|
### Measurements & Fields:
|
|
|
|
Every effort was made to preserve the names based on the JSON response from the
|
|
docker API.
|
|
|
|
Note that the docker_cpu metric may appear multiple times per collection, based
|
|
on the availability of per-cpu stats on your system.
|
|
|
|
- docker_mem
|
|
- total_pgmafault
|
|
- cache
|
|
- mapped_file
|
|
- total_inactive_file
|
|
- pgpgout
|
|
- rss
|
|
- total_mapped_file
|
|
- writeback
|
|
- unevictable
|
|
- pgpgin
|
|
- total_unevictable
|
|
- pgmajfault
|
|
- total_rss
|
|
- total_rss_huge
|
|
- total_writeback
|
|
- total_inactive_anon
|
|
- rss_huge
|
|
- hierarchical_memory_limit
|
|
- total_pgfault
|
|
- total_active_file
|
|
- active_anon
|
|
- total_active_anon
|
|
- total_pgpgout
|
|
- total_cache
|
|
- inactive_anon
|
|
- active_file
|
|
- pgfault
|
|
- inactive_file
|
|
- total_pgpgin
|
|
- max_usage
|
|
- usage
|
|
- failcnt
|
|
- limit
|
|
- docker_cpu
|
|
- throttling_periods
|
|
- throttling_throttled_periods
|
|
- throttling_throttled_time
|
|
- usage_in_kernelmode
|
|
- usage_in_usermode
|
|
- usage_system
|
|
- usage_total
|
|
- docker_net
|
|
- rx_dropped
|
|
- rx_bytes
|
|
- rx_errors
|
|
- tx_packets
|
|
- tx_dropped
|
|
- rx_packets
|
|
- tx_errors
|
|
- tx_bytes
|
|
- docker_blkio
|
|
- io_service_bytes_recursive_async
|
|
- io_service_bytes_recursive_read
|
|
- io_service_bytes_recursive_sync
|
|
- io_service_bytes_recursive_total
|
|
- io_service_bytes_recursive_write
|
|
- io_serviced_recursive_async
|
|
- io_serviced_recursive_read
|
|
- io_serviced_recursive_sync
|
|
- io_serviced_recursive_total
|
|
- io_serviced_recursive_write
|
|
|
|
### Tags:
|
|
|
|
- All stats have the following tags:
|
|
- cont_id (container ID)
|
|
- cont_image (container image)
|
|
- cont_name (container name)
|
|
- docker_cpu specific:
|
|
- cpu
|
|
- docker_net specific:
|
|
- network
|
|
- docker_blkio specific:
|
|
- device
|
|
|
|
### Example Output:
|
|
|
|
```
|
|
% ./telegraf -config ~/ws/telegraf.conf -input-filter docker -test
|
|
* Plugin: docker, Collection 1
|
|
> docker_mem,cont_id=5705ba8ed8fb47527410653d60a8bb2f3af5e62372297c419022a3cc6d45d848,\
|
|
cont_image=spotify/kafka,cont_name=kafka \
|
|
active_anon=52568064i,active_file=6926336i,cache=12038144i,fail_count=0i,\
|
|
hierarchical_memory_limit=9223372036854771712i,inactive_anon=52707328i,\
|
|
inactive_file=5111808i,limit=1044578304i,mapped_file=10301440i,\
|
|
max_usage=140656640i,pgfault=63762i,pgmajfault=2837i,pgpgin=73355i,\
|
|
pgpgout=45736i,rss=105275392i,rss_huge=4194304i,total_active_anon=52568064i,\
|
|
total_active_file=6926336i,total_cache=12038144i,total_inactive_anon=52707328i,\
|
|
total_inactive_file=5111808i,total_mapped_file=10301440i,total_pgfault=63762i,\
|
|
total_pgmafault=0i,total_pgpgin=73355i,total_pgpgout=45736i,\
|
|
total_rss=105275392i,total_rss_huge=4194304i,total_unevictable=0i,\
|
|
total_writeback=0i,unevictable=0i,usage=117440512i,writeback=0i 1453409536840126713
|
|
> docker_cpu,cont_id=5705ba8ed8fb47527410653d60a8bb2f3af5e62372297c419022a3cc6d45d848,\
|
|
cont_image=spotify/kafka,cont_name=kafka,cpu=cpu-total \
|
|
throttling_periods=0i,throttling_throttled_periods=0i,\
|
|
throttling_throttled_time=0i,usage_in_kernelmode=440000000i,\
|
|
usage_in_usermode=2290000000i,usage_system=84795360000000i,\
|
|
usage_total=6628208865i 1453409536840126713
|
|
> docker_cpu,cont_id=5705ba8ed8fb47527410653d60a8bb2f3af5e62372297c419022a3cc6d45d848,\
|
|
cont_image=spotify/kafka,cont_name=kafka,cpu=cpu0 \
|
|
usage_total=6628208865i 1453409536840126713
|
|
> docker_net,cont_id=5705ba8ed8fb47527410653d60a8bb2f3af5e62372297c419022a3cc6d45d848,\
|
|
cont_image=spotify/kafka,cont_name=kafka,network=eth0 \
|
|
rx_bytes=7468i,rx_dropped=0i,rx_errors=0i,rx_packets=94i,tx_bytes=946i,\
|
|
tx_dropped=0i,tx_errors=0i,tx_packets=13i 1453409536840126713
|
|
> docker_blkio,cont_id=5705ba8ed8fb47527410653d60a8bb2f3af5e62372297c419022a3cc6d45d848,\
|
|
cont_image=spotify/kafka,cont_name=kafka,device=8:0 \
|
|
io_service_bytes_recursive_async=80216064i,io_service_bytes_recursive_read=79925248i,\
|
|
io_service_bytes_recursive_sync=77824i,io_service_bytes_recursive_total=80293888i,\
|
|
io_service_bytes_recursive_write=368640i,io_serviced_recursive_async=6562i,\
|
|
io_serviced_recursive_read=6492i,io_serviced_recursive_sync=37i,\
|
|
io_serviced_recursive_total=6599i,io_serviced_recursive_write=107i 1453409536840126713
|
|
```
|