Turnbuckle implements hooks in Docker daemon and extend docker’s client API to support resource introspection and management of docker container’s resource consumption.
It is a docker patch to support two additional client commands:
-
stats (get): To get system level stats about resources utilized by a native container running on docker.
-
set : To set/modify allocated system resources allocated to container at runtime.
This patch works for docker version 1.2.0.
Get Command:
Usage: docker stats [container-id]
Example Usage/Output:
~/docker$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e54efeb51eb8 ubuntu:14.04 "/bin/sh -c 'while t 5 minutes ago Up 5 minutes clever_shockley
1105763b7e03 ubuntu:14.04 "/bin/sh -c 'while t 6 minutes ago Up 6 minutes condescending_tesla
~/docker$ sudo docker stats clever_shockley
Docker Stats
CPU:
Total usage: 327356401
Kernelmode usage: 260000000
UserMode usage: 80000000
Memory:
Current usage: 221184
Maximum usage: 1421312
Fail Count: 0
~/docker$ sudo docker stats condescending_tesla
Docker Stats
CPU:
Total usage: 392069004
Kernelmode usage: 300000000
UserMode usage: 120000000
Memory:
Current usage: 225280
Maximum usage: 1052672
Fail Count: 0Set Command:
Usage: docker set [container-id] resource=value
This patch currently supports modification of cpushares only. This can be further extended by adding support for other parameters like cfs-quota-us
Example Usage/Output:
~/docker$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
90c85dde05d7 ubuntu:14.04 "/bin/sh -c 'while t 11 seconds ago Up 10 seconds silly_hawking
~/docker$ cat /sys/fs/cgroup/cpu/docker/90c85dde05d72c4c615dadf2a6e3da814d676435ee31c12969df7475ee04c449/cpu.shares
1024
~/docker$ sudo docker set silly_hawking cpushares=512
hey! entering In CmdSet....
CmdSet:: name is silly_hawking
CmdSet:: PARAM is cpushares
CmdSet:: VAL is 512
CmdSet:: SET SUCCESSFULLY!!
~/docker$
~/docker$ cat /sys/fs/cgroup/cpu/docker/90c85dde05d72c4c615dadf2a6e3da814d676435ee31c12969df7475ee04c449/cpu.shares
512
~/docker$refer to pdf "behavior_analysis_cgroups"
Patch for latest docker version: COMING SOON!!
For more details: Sakshi Sharma ([email protected])