docker container stats

說明顯示容器資源使用統計資訊的即時串流。
用法docker container stats [選項] [容器...]
別名
docker stats

說明

docker stats 指令會傳回正在執行的容器的即時資料串流。 若要將資料限制為一個或多個特定容器，請指定以空格分隔的容器名稱或 ID 清單。 您可以指定已停止的容器，但已停止的容器不會傳回任何資料。

如果您需要更詳細的容器資源使用資訊，請使用 /containers/(id)/stats API 端點。

**注意**

在 Linux 上，Docker CLI 會從總記憶體使用量中減去快取使用量來報告記憶體使用量。 API 不會執行此類計算，而是提供總記憶體使用量和快取量，以便用戶端根據需要使用資料。 快取使用量定義為 cgroup v1 主機上 memory.stat 檔案中 total_inactive_file 欄位的值。

在 Docker 19.03 和更舊版本中，快取使用量定義為 cache 欄位的值。 在 cgroup v2 主機上，快取使用量定義為 inactive_file 欄位的值。

**注意**

PIDS 欄位包含該容器建立的程序數和核心執行緒數。 執行緒是 Linux 核心使用的術語。 其他等效術語包括「輕量級程序」或「核心任務」等。 PIDS 欄位中的數字很大，而程序數很少（如 ps 或 top 所報告），可能表示容器中的某些東西正在建立許多執行緒。

選項

選項預設值說明
-a, --all顯示所有容器（預設僅顯示正在執行的容器）
--format使用自訂範本格式化輸出
'table'：以表格格式列印輸出，包含欄位標題（預設）
'table 範本'：使用指定的 Go 範本以表格格式列印輸出
'json'：以 JSON 格式列印
'範本'：使用指定的 Go 範本列印輸出。
如需瞭解更多關於使用範本格式化輸出的資訊，請參閱 https://docker-docs.dev.org.tw/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 背景程式上，根據名稱和 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

對名稱為 nginx 的容器執行 docker stats，並以 json 格式取得輸出。

$ 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 和 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 背景程式上，根據名稱和 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)

格式化選項 (--format) 使用 Go 範本漂亮地列印容器輸出。

Go 範本的有效佔位符號如下所示

佔位符號說明
.Container容器名稱或 ID（使用者輸入）
.Name容器名稱
.ID容器 ID
.CPUPercCPU 百分比
.MemUsage記憶體使用量
.NetIO網路輸入/輸出
.BlockIO區塊輸入/輸出
.MemPerc記憶體百分比（Windows 上不適用）
.PIDsPID 數量（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}}"