compose/docs/reference/compose_stats.md
Guillaume Lours e5b5432781 feat(stats): add --all-projects and --aggregate flags
`docker compose stats` only reports on a single project. Add two
opt-in flags, the default behavior being unchanged:

  --all-projects  one line per container for every project, with a
                  PROJECT column
  --aggregate     one line per project, summing the resource usage of
                  its containers; alone, it reports on the current
                  project

Both support the `table` and `json` formats, the latter printing one
object per line like `docker stats`. Unless `--no-stream` is set, they
refresh 2s after each sample. They cannot be combined with a SERVICE,
and `--all-projects` cannot be combined with `--project-name`.

docker/cli does not export its stats collection, so containers are
sampled through the Engine API and the figures computed the same way
`docker stats` does.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Guillaume Lours <glours@users.noreply.github.com>
2026-10-15 06:41:29 +02:00

4.3 KiB

docker compose stats

Display a live stream of container(s) resource usage statistics

Options

Name Type Default Description
--aggregate bool Show one line per project, summing the resource usage of its containers (only 'table' and 'json' formats)
-a, --all bool Show all containers (default shows just running)
--all-projects bool Show the containers of all projects instead of the current one, with their project (only 'table' and 'json' formats)
--dry-run bool Execute command in dry run mode
--format string Format output using a custom template:
'table': Print output in table format with column headers (default)
'table TEMPLATE': Print output in table format using the given Go template
'json': Print in JSON format
'TEMPLATE': Print output using the given Go template.
Refer to https://docs.docker.com/engine/cli/formatting/ for more information about formatting output with templates
--no-stream bool Disable streaming stats and only pull the first result
--no-trunc bool Do not truncate output