1. docker
  2. Commit 7a36d55a86e5d443f1de5b7b32d710cc65671a92
Browse code

[Docs] Add docs for stating stopped containers

This commit adds docs with example showing `docker stats` stopped
containers.

Signed-off-by: Zhang Wei <zhangwei555@huawei.com>

Zhang Wei authored on 2017/02/15 15:20:30
Showing 2 changed files
docs/reference/commandline/stats.md
History View file @ 7a36d55
... ... 
@@ -54,6 +54,19 @@ CONTAINER           CPU %               MEM USAGE/LIMIT       MEM %
54 54 
 fervent_panini      0.02%               11.08 MiB/1.045 GiB   1.06%               648 B/648 B
55 55 
 ```
56 56
57 
+Running `docker stats` with customized format on all (Running and Stopped) containers.
58 
+
59 
+```bash
60 
+$ docker stats --all --format "table {{.ID}}\t{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"
61 
+CONTAINER ID                                                       NAME                     CPU %               MEM USAGE / LIMIT
62 
+c9dfa83f0317f87637d5b7e67aa4223337d947215c5a9947e697e4f7d3e0f834   ecstatic_noether         0.00%               56KiB / 15.57GiB
63 
+8f92d01cf3b29b4f5fca4cd33d907e05def7af5a3684711b20a2369d211ec67f   stoic_goodall            0.07%               32.86MiB / 15.57GiB
64 
+38dd23dba00f307d53d040c1d18a91361bbdcccbf592315927d56cf13d8b7343   drunk_visvesvaraya       0.00%               0B / 0B
65 
+5a8b07ec4cc52823f3cbfdb964018623c1ba307bce2c057ccdbde5f4f6990833   big_heisenberg           0.00%               0B / 0B
66 
+```
67 
+
68 
+`drunk_visvesvaraya` and `big_heisenberg` are stopped containers in the above example.
69 
+
57 70 
 Running `docker stats` on all running containers against a Windows daemon.
58 71
59 72 
 ```powershell
man/src/container/stats.md
History View file @ 7a36d55
... ... 
@@ -16,7 +16,7 @@ Display a live stream of one or more containers' resource usage statistics
16 16
17 17 
 # EXAMPLES
18 18
19 
-Running `docker container stats` on all running containers
19 
+Running `docker container stats` on all running containers.
20 20
21 21 
     $ docker container stats
22 22 
     CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O
... ... 
@@ -30,3 +30,14 @@ Running `docker container stats` on multiple containers by name and id.
30 30 
     CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O
31 31 
     5acfcb1b4fd1        0.00%               115.2 MiB/1.045 GiB   11.03%              1.422 kB/648 B
32 32 
     fervent_panini      0.02%               11.08 MiB/1.045 GiB   1.06%               648 B/648 B
33 
+
34 
+Running `docker container stats` with customized format on all (Running and Stopped) containers.
35 
+
36 
+    $ docker container stats --all --format "table {{.ID}}\t{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"
37 
+    CONTAINER ID                                                       NAME                     CPU %               MEM USAGE / LIMIT
38 
+    c9dfa83f0317f87637d5b7e67aa4223337d947215c5a9947e697e4f7d3e0f834   ecstatic_noether         0.00%               56KiB / 15.57GiB
39 
+    8f92d01cf3b29b4f5fca4cd33d907e05def7af5a3684711b20a2369d211ec67f   stoic_goodall            0.07%               32.86MiB / 15.57GiB
40 
+    38dd23dba00f307d53d040c1d18a91361bbdcccbf592315927d56cf13d8b7343   drunk_visvesvaraya       0.00%               0B / 0B
41 
+    5a8b07ec4cc52823f3cbfdb964018623c1ba307bce2c057ccdbde5f4f6990833   big_heisenberg           0.00%               0B / 0B
42 
+
43 
+`drunk_visvesvaraya` and `big_heisenberg` are stopped containers in the above example.