52a8694705
Change the docs markdown so that flag names will be h4 headers. Sphinx will automatically add anchors to headers. Add css to make sure the flag names are not to big compared to the text. The man pages also still renders fine but it looks a bit different. Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
2.6 KiB
% podman-pod-stats(1)
NAME
podman-pod-stats - Display a live stream of resource usage stats for containers in one or more pods
SYNOPSIS
podman pod stats [options] [pod]
DESCRIPTION
Display a live stream of containers in one or more pods resource usage statistics. Running rootless is only supported on cgroups v2.
OPTIONS
--all, -a
Show all containers. Only running containers are shown by default
--latest, -l
Instead of providing the pod name or ID, use the last created pod.
The latest option is not supported on the remote client.
--no-reset
Do not clear the terminal/screen in between reporting intervals
--no-stream
Disable streaming pod stats and only pull the first result, default setting is false
--format=template
Pretty-print container statistics to JSON or using a Go template
Valid placeholders for the Go template are listed below:
| Placeholder | Description |
|---|---|
| .Pod | Pod ID |
| .CID | Container ID |
| .Name | Container Name |
| .CPU | CPU percentage |
| .MemUsage | Memory usage |
| .Mem | Memory percentage |
| .NetIO | Network IO |
| .BlockIO | Block IO |
| .PIDS | Number of PIDs |
When using a GO template, you may precede the format with table to print headers.
EXAMPLE
# podman pod stats -a --no-stream
ID NAME CPU % MEM USAGE / LIMIT MEM % NET IO BLOCK IO PIDS
a9f807ffaacd frosty_hodgkin -- 3.092MB / 16.7GB 0.02% -- / -- -- / -- 2
3b33001239ee sleepy_stallman -- -- / -- -- -- / -- -- / -- --
# podman pod stats --no-stream a9f80
ID NAME CPU % MEM USAGE / LIMIT MEM % NET IO BLOCK IO PIDS
a9f807ffaacd frosty_hodgkin -- 3.092MB / 16.7GB 0.02% -- / -- -- / -- 2
# podman pod stats --no-stream --format=json a9f80
[
{
"id": "a9f807ffaacd",
"name": "frosty_hodgkin",
"cpu_percent": "--",
"mem_usage": "3.092MB / 16.7GB",
"mem_percent": "0.02%",
"netio": "-- / --",
"blocki": "-- / --",
"pids": "2"
}
]
# podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
ID NAME MEM USAGE / LIMIT
6eae9e25a564 clever_bassi 3.031MB / 16.7GB
SEE ALSO
podman-pod(1), podman(1)
HISTORY
February 2019, Originally compiled by Dan Walsh dwalsh@redhat.com