github.com/zhuohuang-hust/src-cbuild@v0.0.0-20230105071821-c7aab3e7c840/man/docker-stats.1.md (about)

     1  % DOCKER(1) Docker User Manuals
     2  % Docker Community
     3  % JUNE 2014
     4  # NAME
     5  docker-stats - Display a live stream of one or more containers' resource usage statistics
     6  
     7  # SYNOPSIS
     8  **docker stats**
     9  [**-a**|**--all**]
    10  [**--help**]
    11  [**--no-stream**]
    12  [**--format[="*TEMPLATE*"]**]
    13  [CONTAINER...]
    14  
    15  # DESCRIPTION
    16  
    17  Display a live stream of one or more containers' resource usage statistics
    18  
    19  # OPTIONS
    20  **-a**, **--all**=*true*|*false*
    21     Show all containers. Only running containers are shown by default. The default is *false*.
    22  
    23  **--help**
    24    Print usage statement
    25  
    26  **--no-stream**=*true*|*false*
    27    Disable streaming stats and only pull the first result, default setting is false.
    28  
    29  **--format**="*TEMPLATE*"
    30     Pretty-print containers statistics using a Go template.
    31     Valid placeholders:
    32        .Container - Container name or ID.
    33        .Name - Container name.
    34        .ID - Container ID.
    35        .CPUPerc - CPU percentage.
    36        .MemUsage - Memory usage.
    37        .NetIO - Network IO.
    38        .BlockIO - Block IO.
    39        .MemPerc - Memory percentage (Not available on Windows).
    40        .PIDs - Number of PIDs (Not available on Windows).
    41  
    42  # EXAMPLES
    43  
    44  Running `docker stats` on all running containers
    45  
    46      $ docker stats
    47      CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O
    48      1285939c1fd3        0.07%               796 KiB / 64 MiB        1.21%               788 B / 648 B       3.568 MB / 512 KB
    49      9c76f7834ae2        0.07%               2.746 MiB / 64 MiB      4.29%               1.266 KB / 648 B    12.4 MB / 0 B
    50      d1ea048f04e4        0.03%               4.583 MiB / 64 MiB      6.30%               2.854 KB / 648 B    27.7 MB / 0 B
    51  
    52  Running `docker stats` on multiple containers by name and id.
    53  
    54      $ docker stats fervent_panini 5acfcb1b4fd1
    55      CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O
    56      5acfcb1b4fd1        0.00%               115.2 MiB/1.045 GiB   11.03%              1.422 kB/648 B
    57      fervent_panini      0.02%               11.08 MiB/1.045 GiB   1.06%               648 B/648 B