The Docker CLI
Go to file
Sebastiaan van Stijn 0a78472211
Update default output format for stats to include ID and Name
The `docker container stats` output has a column (`CONTAINER`), that shows either
the container _id_ or container _name_, depending on the arguments given.

For example, running `docker container stats foobar` shows:

    CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
    foobar              0.00%               1.938MiB / 1.952GiB   0.10%               782B / 0B           4.11MB / 0B         2

Whereas `docker container stats 67b2525d8ad1` (`67b2525d8ad1` being the ID for
container `foobar`) shows:

    CONTAINER           CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
    67b2525d8ad1        0.00%               1.938MiB / 1.952GiB   0.10%               916B / 0B           4.11MB / 0B         2

This behavior is confusing.

This patch updates the default output format for `docker stats` to use separate
columns for container ID and container Name (similar to `docker container ls`).

With this patch applied, both commands show the same output:

    $ docker container stats foobar
    CONTAINER ID                                                       NAME                CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
    67b2525d8ad10bb236a49960e93c09993b0baabeef12c2d46cd5f4fbb6f4808c   foobar              0.00%               1.938MiB / 1.952GiB   0.10%               1.25kB / 0B         4.11MB / 0B         2

    $ docker container stats 67b2525d8ad1
    CONTAINER ID                                                       NAME                CPU %               MEM USAGE / LIMIT     MEM %               NET I/O             BLOCK I/O           PIDS
    67b2525d8ad10bb236a49960e93c09993b0baabeef12c2d46cd5f4fbb6f4808c   foobar              0.00%               1.938MiB / 1.952GiB   0.10%               1.31kB / 0B         4.11MB / 0B         2

Users that want to use the old format can configure a custom format in the
cli configuration file (`~/.docker/config.json`);

on Linux:

    {
      "statsFormat" : "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.MemPerc}}\t{{.NetIO}}\t{{.BlockIO}}\t{{.PIDs}}"
    }

on Windows:

    {
      "statsFormat" : "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.NetIO}}\t{{.BlockIO}}"
    }

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2017-09-27 18:05:51 +02:00
.github Add myself to command/stack codeowners 2017-07-20 12:05:20 -04:00
cli Update default output format for stats to include ID and Name 2017-09-27 18:05:51 +02:00
cmd/docker updated vendoring 2017-09-01 19:41:06 -04:00
contrib/completion Merge pull request #504 from albers/completion-search--format 2017-09-20 14:41:28 +02:00
dockerfiles Update gometalinter 2017-09-26 12:33:35 -04:00
docs Merge pull request #562 from dnephin/update-gometalinter 2017-09-27 09:42:37 +02:00
e2e Fix e2e test by using a pinned version of alpine 2017-09-14 11:38:46 -04:00
experimental Fix Markdown formatting of experimental "stacks" 2017-06-20 15:15:08 -07:00
internal/test tests: address review feedback 2017-09-25 09:38:41 -07:00
man Fix nocopy description 2017-09-20 16:43:15 +02:00
opts Use new internal testutil.ErrorContains() 2017-08-22 10:14:25 -04:00
scripts Fix e2e test by using a pinned version of alpine 2017-09-14 11:38:46 -04:00
service/logs Use a local copy of ParseLogDetails 2017-09-07 12:50:25 -04:00
templates Import `docker/docker/pkg/templates` to cli 2017-08-08 17:26:24 +02:00
vendor Merge pull request #451 from tych0/use-pass-backend 2017-09-26 16:40:32 +02:00
.dockerignore make go build and docker build operations faster 2017-04-27 15:06:57 -07:00
.gitignore Add scripts and targets for manpages and yamldocs 2017-06-05 19:10:44 +00:00
CONTRIBUTING.md Add Contribution guidelines 2017-07-28 11:33:19 -07:00
Jenkinsfile Add a Jenkinsfile 2017-08-16 10:46:43 -04:00
LICENSE Add project files 2017-04-17 17:49:33 -04:00
MAINTAINERS Add albers to maintainers. 2017-09-11 11:22:10 -04:00
Makefile Add a way to just build windows and osx 2017-09-19 16:48:31 -07:00
NOTICE Add project files 2017-04-17 17:49:33 -04:00
README.md Add jenkins build status to readme 2017-09-15 15:08:28 +02:00
TESTING.md Add TESTING document. 2017-08-24 14:45:50 -04:00
VERSION Bump version to 17.10.0-dev 2017-09-13 14:08:56 +02:00
circle.yml Set DISABLE_WARN_OUTSIDE_CONTAINER in the Dockerfile so that we don't spend 10s sleeping in CI 2017-08-15 14:34:43 -04:00
codecov.yml Update codecov project threshold to 15% 2017-06-07 13:26:24 +02:00
docker.Makefile Add a way to just build windows and osx 2017-09-19 16:48:31 -07:00
gometalinter.json Refactor image commands to make use of the new trust struct for trusted pull 2017-09-26 15:15:42 -04:00
poule.yml Add github templates and initial poule configuration 2017-05-09 16:57:46 +02:00
vendor.conf Merge pull request #451 from tych0/use-pass-backend 2017-09-26 16:40:32 +02:00

README.md

build status Build Status

docker/cli

This repository is the home of the cli used in the Docker CE and Docker EE products.

Development

docker/cli is developed using Docker.

Build a linux binary:

$ make -f docker.Makefile binary

Build binaries for all supported platforms:

$ make -f docker.Makefile cross

Run all linting:

$ make -f docker.Makefile lint

List all the available targets:

$ make help

In-container development environment

Start an interactive development environment:

$ make -f docker.Makefile shell

In the development environment you can run many tasks, including build binaries:

$ make binary

Legal

Brought to you courtesy of our legal counsel. For more context, please see the NOTICE document in this repo.

Use and transfer of Docker may be subject to certain restrictions by the United States and other governments.

It is your responsibility to ensure that your use and/or transfer does not violate applicable laws.

For more information, please see https://www.bis.doc.gov

Licensing

docker/cli is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.