docker stats

1. docker stats

1.1. 描述

显示实时的容器资源使用情况统计

不加容器ID则显示所有运行中容器的信息。要将数据限制到一个或多个特定容器，请指定一列用空格分隔的容器名称或ID。

查看运行中的容器资源状态信息，也可以指定已停止的容器，但是不会返回任何信息。

如果需要有关容器资源使用情况的更多详细信息，请使用 /containers/(id)/statsAPI。

注意：
在 Linux 上，Docker CLI 通过从总内存使用量中减去页面缓存使用率来报告内存使用情况。API 不执行这种计算，而是提供总的内存使用量和页面缓存中的内存量，以便客户端可以根据需要使用数据。
注意：
该 PIDS 列包含该容器创建的进程和内核线程的数量。线程是 Linux 内核使用的术语。其他等效术语是“轻量级进程”或“内核任务”等。该 PIDS 列中的大量数字与少量进程（如 ps 或 top）相结合可能表明容器中的某些内容正在创建许多线程。

1.2. 帮助

$ docker stats --help

Usage: docker stats [OPTIONS] [CONTAINER...]

Display a live stream of container(s) resource usage statistics

Options:
  -a, --all Show all containers (default shows just running)
      --format string Pretty-print images using a Go template
      --no-stream Disable streaming stats and only pull the first result
      --no-trunc Do not truncate output

1.3. 选项

选项	默认	描述
--all, -a	-	查看所有容器信息(默认只显示运行中的)。类似top一样实时的显示容器状态信息
--format	-	Go模板渲染展示输出信息
--no-stream	-	禁用流统计信息，仅获取第一个结果。类似 `top -n 1`，只输出一次数据就退出，不实时统计
--no-trunc	-	不截断容器信息，例如展示容器完整64位ID

1.4. 示例

1.4.1. 显示当前机器所有运行中容器的状态信息

$ docker stats

CONTAINER ID        NAME                                    CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
b95a83497c91        awesome_brattain                        0.28%               5.629MiB / 1.952GiB   0.28%               916B / 0B           147kB / 0B          9
67b2525d8ad1        foobar                                  0.00%               1.727MiB / 1.952GiB   0.09%               2.48kB / 0B         4.11MB / 0B         2
e5c383697914        test-1951.1.kay7x1lh1twk9c0oig50sd5tr   0.00%               196KiB / 1.952GiB     0.01%               71.2kB / 0B         770kB / 0B          1
4bda148efbc0        random.1.vnc8on831idyr42slu578u3cr      0.00%               1.672MiB / 1.952GiB   0.08%               110kB / 0B          578kB / 0B          2

如果没有指定 --format 格式化输出，那么将会有如下几列

列名	描述
CONTAINER ID 和 Name	容器的ID和名称
CPU % 和 MEM %	容器正在使用的主机CPU和内存的百分比
MEM USAGE / LIMIT	容器正在使用的总内存以及允许使用的总内存量
NET I/O	容器通过其网络接口发送和接收的数据量
BLOCK I/O	容器已从主机上的块设备读取和写入的数据量
PIDs	容器创建的进程或线程数

docker stats 针对 Linux 守护程序，通过名称和 ID 在多个容器上运行。

$ docker stats awesome_brattain 67b2525d8ad1

CONTAINER ID        NAME                CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
b95a83497c91        awesome_brattain    0.28%               5.629MiB / 1.952GiB   0.28%               916B / 0B           147kB / 0B          9
67b2525d8ad1        foobar              0.00%               1.727MiB / 1.952GiB   0.09%               2.48kB / 0B         4.11MB / 0B         2

运行 docker stats 与所有的自定义格式（运行和停止）的容器。

$ docker stats --all --format "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}" fervent_panini 5acfcb1b4fd1 drunk_visvesvaraya big_heisenberg

CONTAINER                CPU %               MEM USAGE / LIMIT
fervent_panini           0.00%               56KiB / 15.57GiB
5acfcb1b4fd1             0.07%               32.86MiB / 15.57GiB
drunk_visvesvaraya       0.00%               0B / 0B
big_heisenberg           0.00%               0B / 0B

drunk_visvesvaraya 和 big_heisenberg 在上面的例子中被停止的容器。

运行 docker stats 在所有运行集装箱对 Windows 守护进程。

PS E:\> docker stats
CONTAINER ID        CPU %               PRIV WORKING SET    NET I/O             BLOCK I/O
09d3bb5b1604        6.61%               38.21 MiB           17.1 kB / 7.73 kB   10.7 MB / 3.57 MB
9db7aa4d986d        9.19%               38.26 MiB           15.2 kB / 7.65 kB   10.6 MB / 3.3 MB
3f214c61ad1d        0.00%               28.64 MiB           64 kB / 6.84 kB     4.42 MB / 6.93 MB

docker stats 针对 Windows 守护程序，通过名称和 ID 在多个容器上运行。

PS E:\> docker ps -a
CONTAINER ID        NAME                IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
3f214c61ad1d        awesome_brattain    nanoserver          "cmd"               2 minutes ago       Up 2 minutes                            big_minsky
9db7aa4d986d        mad_wilson          windowsservercore   "cmd"               2 minutes ago       Up 2 minutes                            mad_wilson
09d3bb5b1604        fervent_panini      windowsservercore   "cmd"               2 minutes ago       Up 2 minutes                            affectionate_easley

PS E:\> docker stats 3f214c61ad1d mad_wilson
CONTAINER ID        NAME                CPU %               PRIV WORKING SET    NET I/O             BLOCK I/O
3f214c61ad1d        awesome_brattain    0.00%               46.25 MiB           76.3 kB / 7.92 kB   10.3 MB / 14.7 MB
9db7aa4d986d        mad_wilson          9.59%               40.09 MiB           27.6 kB / 8.81 kB   17 MB / 20.1 MB

1.4.2. 格式化

格式化选项（--format）使用Go模板漂亮地打印了容器输出。

下面列出了Go模板的有效占位符：

列名	描述
.Container	容器名称或ID（用户输入）
.Name	容器名称
.ID	编号
.CPUPerc	CPU百分比
.MemUsage	内存使用情况
.NetIO	网络IO
.BlockIO	块IO
.MemPerc	内存百分比（在Windows上不可用）
.PIDs	PID数量（在Windows上不可用）

使用该 --format 选项时，stats 命令要么完全按照模板声明的方式输出数据，要么使用 table 指令时也包括列标题。

以下示例使用没有标题的模板，Container 并 CPUPerc 为所有图像输出用冒号分隔的和条目：

$ docker stats --format "{{.Container}}: {{.CPUPerc}}"

09d3bb5b1604: 6.61%
9db7aa4d986d: 9.19%
3f214c61ad1d: 0.00%

要以表格式列出所有容器统计信息及其名称，CPU 百分比和内存使用情况，可以使用：

$ docker stats --format "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}"

CONTAINER           CPU %               PRIV WORKING SET
1285939c1fd3        0.07%               796 KiB / 64 MiB
9c76f7834ae2        0.07%               2.746 MiB / 64 MiB
d1ea048f04e4        0.03%               4.583 MiB / 64 MiB

默认格式如下：

在Linux上：

"table {{.ID}}\t{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.MemPerc}}\t{{.NetIO}}\t{{.BlockIO}}\t{{.PIDs}}"

在Windows上：

"table {{.ID}}\t{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.NetIO}}\t{{.BlockIO}}"

注意：
在 Docker 17.09 及更早版本上，使用 {% raw %}{{.Container}}{% endraw %} 列代替 {% raw %}{{.ID}}\t{{.Name}}{% endraw %}。

docker stats