mirror of
https://github.com/docker/compose.git
synced 2026-11-17 21:57:19 +00:00
`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>
20 lines
4.3 KiB
Markdown
20 lines
4.3 KiB
Markdown
# docker compose stats
|
|
|
|
<!---MARKER_GEN_START-->
|
|
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:<br>'table': Print output in table format with column headers (default)<br>'table TEMPLATE': Print output in table format using the given Go template<br>'json': Print in JSON format<br>'TEMPLATE': Print output using the given Go template.<br>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 |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|