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


.SH NAME
.PP
docker\-stats \- Display a live stream of one or more containers' resource usage statistics


.SH SYNOPSIS
.PP
\fBdocker stats\fP
[\fB\-a\fP|\fB\-\-all\fP]
[\fB\-\-help\fP]
[\fB\-\-no\-stream\fP]
[CONTAINER...]


.SH DESCRIPTION
.PP
Display a live stream of one or more containers' resource usage statistics


.SH OPTIONS
.PP
\fB\-a\fP, \fB\-\-all\fP=\fItrue\fP|\fIfalse\fP
   Show all containers. Only running containers are shown by default. The default is \fIfalse\fP.

.PP
\fB\-\-help\fP
  Print usage statement

.PP
\fB\-\-no\-stream\fP=\fItrue\fP|\fIfalse\fP
  Disable streaming stats and only pull the first result, default setting is false.


.SH EXAMPLES
.PP
Running \fB\fCdocker stats\fR on all running containers

.PP
.RS

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

.fi
.RE

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

.PP
.RS

.nf
$ docker stats fervent\_panini 5acfcb1b4fd1
CONTAINER           CPU %               MEM USAGE/LIMIT     MEM %               NET I/O
5acfcb1b4fd1        0.00%               115.2 MB/1.045 GB   11.03%              1.422 kB/648 B
fervent\_panini      0.02%               11.08 MB/1.045 GB   1.06%               648 B/648 B

.fi
.RE