mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Yong Tang 0e3846e280 Change HumanSize to BytesSize for memory output in docker stats.

This fix tries to fix the discrepancy between `docker stats` and
`docker run` where `docker run` uses RAMInBytes for all memory
related inputs but `docker stats` uses HumanSize for all memory
related outputs.

To be consistent, `docker stats` needs to use BytesSize for all
memory related outputs to conform to RAMInBytes in `docker run`.

This fix addresses this issue. As BytesSize is used, the test
cases needs to be adjusted to match `KiB/MiB/GiB` instead of
`KB/MB/GB`.

The documentation has also been updated.

This fix fixes #21765.

Signed-off-by: Yong Tang <yong.tang.github@outlook.com>

2016-04-08 20:01:50 +00:00

1.6 KiB

Raw Blame History

% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014

NAME

docker-stats - Display a live stream of one or more containers' resource usage statistics

SYNOPSIS

docker stats [-a|--all] [--help] [--no-stream] [CONTAINER...]

DESCRIPTION

Display a live stream of one or more containers' resource usage statistics

OPTIONS

-a, --all=true|false Show all containers. Only running containers are shown by default. The default is false.

--help Print usage statement

--no-stream=true|false Disable streaming stats and only pull the first result, default setting is false.

EXAMPLES

Running docker stats on all running containers

$ docker stats
CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O
1285939c1fd3        0.07%               796 KiB / 64 MiB        1.21%               788 B / 648 B       3.568 MB / 512 KB
9c76f7834ae2        0.07%               2.746 MiB / 64 MiB      4.29%               1.266 KB / 648 B    12.4 MB / 0 B
d1ea048f04e4        0.03%               4.583 MiB / 64 MiB      6.30%               2.854 KB / 648 B    27.7 MB / 0 B

Running docker stats on multiple containers by name and id.

$ docker stats fervent_panini 5acfcb1b4fd1
CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O
5acfcb1b4fd1        0.00%               115.2 MiB/1.045 GiB   11.03%              1.422 kB/648 B
fervent_panini      0.02%               11.08 MiB/1.045 GiB   1.06%               648 B/648 B

1.6 KiB Raw Blame History