1 .TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "JUNE 2014"  ""

     2 

     3 

     4 .SH NAME

     5 .PP

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

     7 

     8 

     9 .SH SYNOPSIS

    10 .PP

    11 \fBdocker stats\fP

    12 [\fB\-a\fP|\fB\-\-all\fP]

    13 [\fB\-\-help\fP]

    14 [\fB\-\-no\-stream\fP]

    15 [CONTAINER...]

    16 

    17 

    18 .SH DESCRIPTION

    19 .PP

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

    21 

    22 

    23 .SH OPTIONS

    24 .PP

    25 \fB\-a\fP, \fB\-\-all\fP=\fItrue\fP|\fIfalse\fP

    26    Show all containers. Only running containers are shown by default. The default is \fIfalse\fP.

    27 

    28 .PP

    29 \fB\-\-help\fP

    30   Print usage statement

    31 

    32 .PP

    33 \fB\-\-no\-stream\fP=\fItrue\fP|\fIfalse\fP

    34   Disable streaming stats and only pull the first result, default setting is false.

    35 

    36 

    37 .SH EXAMPLES

    38 .PP

    39 Running \fB\fCdocker stats\fR on all running containers

    40 

    41 .PP

    42 .RS

    43 

    44 .nf

    45 $ docker stats

    46 CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O

    47 1285939c1fd3        0.07%               796 KB / 64 MB        1.21%               788 B / 648 B       3.568 MB / 512 KB

    48 9c76f7834ae2        0.07%               2.746 MB / 64 MB      4.29%               1.266 KB / 648 B    12.4 MB / 0 B

    49 d1ea048f04e4        0.03%               4.583 MB / 64 MB      6.30%               2.854 KB / 648 B    27.7 MB / 0 B

    50 

    51 .fi

    52 .RE

    53 

    54 .PP

    55 Running \fB\fCdocker stats\fR on multiple containers by name and id.

    56 

    57 .PP

    58 .RS

    59 

    60 .nf

    61 $ docker stats fervent\_panini 5acfcb1b4fd1

    62 CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O

    63 5acfcb1b4fd1        0.00%               115.2 MB/1.045 GB   11.03%              1.422 kB/648 B

    64 fervent\_panini      0.02%               11.08 MB/1.045 GB   1.06%               648 B/648 B

    65 

    66 .fi

    67 .RE