1DOCKER(1) JUNE 2014 DOCKER(1)
2
3
4
6 docker-stats - Display a live stream of one or more containers'
7 resource usage statistics
8
9
10
12 docker stats [-a|--all] [--help] [--no-stream] [--format[="TEMPLATE"]]
13 [CONTAINER...]
14
15
16
18 Display a live stream of one or more containers' resource usage
19 statistics
20
21
22
24 -a, --all=true|false
25 Show all containers. Only running containers are shown by default.
26 The default is false.
27
28
29 --help
30 Print usage statement
31
32
33 --no-stream=true|false
34 Disable streaming stats and only pull the first result, default
35 setting is false.
36
37
38 --format="TEMPLATE"
39 Pretty-print containers statistics using a Go template.
40 Valid placeholders:
41 .Container - Container name or ID.
42 .Name - Container name.
43 .ID - Container ID.
44 .CPUPerc - CPU percentage.
45 .MemUsage - Memory usage.
46 .NetIO - Network IO.
47 .BlockIO - Block IO.
48 .MemPerc - Memory percentage (Not available on Windows).
49 .PIDs - Number of PIDs (Not available on Windows).
50
51
52
54 Running docker stats on all running containers
55
56
57 $ docker stats
58 CONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O
59 1285939c1fd3 0.07% 796 KiB / 64 MiB 1.21% 788 B / 648 B 3.568 MB / 512 KB
60 9c76f7834ae2 0.07% 2.746 MiB / 64 MiB 4.29% 1.266 KB / 648 B 12.4 MB / 0 B
61 d1ea048f04e4 0.03% 4.583 MiB / 64 MiB 6.30% 2.854 KB / 648 B 27.7 MB / 0 B
62
63
64
65 Running docker stats on multiple containers by name and id.
66
67
68 $ docker stats fervent_panini 5acfcb1b4fd1
69 CONTAINER CPU % MEM USAGE/LIMIT MEM % NET I/O
70 5acfcb1b4fd1 0.00% 115.2 MiB/1.045 GiB 11.03% 1.422 kB/648 B
71 fervent_panini 0.02% 11.08 MiB/1.045 GiB 1.06% 648 B/648 B
72
73
74
75
76Docker Community Docker User Manuals DOCKER(1)