github.com/sijibomii/docker@v0.0.0-20231230191044-5cf6ca554647/docs/reference/commandline/stats.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "stats"
     4  description = "The stats command description and usage"
     5  keywords = ["container, resource, statistics"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # stats
    12  
    13      Usage: docker stats [OPTIONS] [CONTAINER...]
    14  
    15      Display a live stream of one or more containers' resource usage statistics
    16  
    17        -a, --all          Show all containers (default shows just running)
    18        --help             Print usage
    19        --no-stream        Disable streaming stats and only pull the first result
    20  
    21  The `docker stats` command returns a live data stream for running containers. To limit data to one or more specific containers, specify a list of container names or ids separated by a space. You can specify a stopped container but stopped containers do not return any data.
    22  
    23  If you want more detailed information about a container's resource usage, use the `/containers/(id)/stats` API endpoint. 
    24  
    25  ## Examples
    26  
    27  Running `docker stats` on all running containers
    28  
    29      $ docker stats
    30      CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O
    31      1285939c1fd3        0.07%               796 KiB / 64 MiB        1.21%               788 B / 648 B       3.568 MB / 512 KB
    32      9c76f7834ae2        0.07%               2.746 MiB / 64 MiB      4.29%               1.266 KB / 648 B    12.4 MB / 0 B
    33      d1ea048f04e4        0.03%               4.583 MiB / 64 MiB      6.30%               2.854 KB / 648 B    27.7 MB / 0 B
    34  
    35  Running `docker stats` on multiple containers by name and id.
    36  
    37      $ docker stats fervent_panini 5acfcb1b4fd1
    38      CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O
    39      5acfcb1b4fd1        0.00%               115.2 MiB/1.045 GiB   11.03%              1.422 kB/648 B
    40      fervent_panini      0.02%               11.08 MiB/1.045 GiB   1.06%               648 B/648 B