Docker 容器统计信息

描述	显示容器资源使用情况统计信息的实时流
用法	`docker container stats [OPTIONS] [CONTAINER...]`
别名	`docker stats`

描述

该命令返回正在运行的容器的实时数据流。自将数据限制为一个或多个特定容器，指定容器名称列表或 ID 之间用空格分隔。您可以指定已停止但已停止的容器容器不返回任何数据。docker stats

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

注意
在 Linux 上，Docker CLI 通过从总内存使用量。API 不执行此类计算，而是提供总内存使用量和缓存量，以便客户端可以根据需要使用数据。缓存使用情况定义为 cgroup v1 主机上文件中的 field 值。total_inactive_filememory.stat
在 Docker 19.03 及更早版本中，缓存使用情况定义为 field 的值。在 cgroup v2 主机上，缓存使用情况定义为 field 的值。cacheinactive_file

注意
该列包含创建的进程数和内核线程数通过该容器。线程是 Linux 内核使用的术语。其他等效项术语是 “lightweight process” 或 “kernel task” 等。列中的大量数字与少量进程（如或报告）相结合，可能表示容器中的某些内容正在创建许多线程。PIDSPIDSpstop

选项

选择	违约	描述
`-a, --all`		Show all containers （default show just running）（默认仅显示正在运行的容器）
`--format`		使用自定义模板格式化输出： 'table'：以带有列标题的表格格式打印输出（默认） 'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出'json'：以 JSON 格式打印'TEMPLATE'：使用给定的 Go 模板打印输出。有关使用模板设置输出格式的更多信息，请参阅 https://docs.docker.com/go/formatting/
`--no-stream`		禁用流式处理统计信息，仅提取第一个结果
`--no-trunc`		不截断输出

例子

针对 Linux 守护程序在所有正在运行的容器上运行。docker stats

$ 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`	容器已创建的进程数或线程数

针对 Linux 守护程序按 name 和 id 在多个容器上运行。docker stats

$ 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

在具有 name 的容器上运行，并获取格式输出。docker statsnginxjson

$ docker stats nginx --no-stream --format "{{ json . }}"
{"BlockIO":"0B / 13.3kB","CPUPerc":"0.03%","Container":"nginx","ID":"ed37317fbf42","MemPerc":"0.24%","MemUsage":"2.352MiB / 982.5MiB","Name":"nginx","NetIO":"539kB / 606kB","PIDs":"2"}

在所有（正在运行和已停止）容器上以自定义格式运行。docker stats

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

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

humble_visvesvaraya，在上面的示例中是 stopped 的容器。big_heisenberg

针对 Windows 守护程序在所有正在运行的容器上运行。docker stats

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

针对 Windows 守护程序按 name 和 id 在多个容器上运行。docker stats

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

设置输出格式（--format）

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

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

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

使用该选项时，命令完全按照模板声明的方式输出数据，或者在使用指令时，还包括列标题。--formatstatstable

以下示例使用不带标头的模板，并输出所有镜像的 and 条目（以冒号（）分隔）：ContainerCPUPerc:

$ 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 容器统计信息

描述

选项

例子

设置输出格式 （--format）

设置输出格式（--format）