mirror of
https://github.com/containers/podman.git
synced 2025-12-12 09:50:25 +08:00
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>
93 lines
2.6 KiB
Markdown
93 lines
2.6 KiB
Markdown
% 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>
|