.nh
.TH podman\-pod\-stats(1)
.SH NAME
.PP
podman\-pod\-stats \- Display a live stream of resource usage stats for containers in one or more pods

.SH SYNOPSIS
.PP
\fBpodman pod stats\fP [\fIoptions\fP] [\fIpod\fP]

.SH DESCRIPTION
.PP
Display a live stream of containers in one or more pods resource usage statistics.  Running rootless is only supported on cgroups v2.

.SH OPTIONS
.SS \fB\-\-all\fP, \fB\-a\fP
.PP
Show all containers.  Only running containers are shown by default

.SS \fB\-\-latest\fP, \fB\-l\fP
.PP
Instead of providing the pod name or ID, use the last created pod.

.PP
The latest option is not supported on the remote client.

.SS \fB\-\-no\-reset\fP
.PP
Do not clear the terminal/screen in between reporting intervals

.SS \fB\-\-no\-stream\fP
.PP
Disable streaming pod stats and only pull the first result, default setting is false

.SS \fB\-\-format\fP=\fItemplate\fP
.PP
Pretty\-print container statistics to JSON or using a Go template

.PP
Valid placeholders for the Go template are listed below:

.TS
allbox;
l l 
l l .
\fB\fC\fBPlaceholder\fP\fR	\fB\fC\fBDescription\fP\fR
\&.Pod	Pod ID
\&.CID	Container ID
\&.Name	Container Name
\&.CPU	CPU percentage
\&.MemUsage	Memory usage
\&.MemUsageBytes	Memory usage (IEC)
\&.Mem	Memory percentage
\&.NetIO	Network IO
\&.BlockIO	Block IO
\&.PIDS	Number of PIDs
.TE

.PP
When using a GO template, you may precede the format with \fB\fCtable\fR to print headers.

.SH EXAMPLE
.PP
.RS

.nf
# 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   \-\-      \-\- / \-\-             \-\-      \-\- / \-\-   \-\- / \-\-    \-\-

.fi
.RE

.PP
.RS

.nf
# 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

.fi
.RE

.PP
.RS

.nf
# 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"
    }
]

.fi
.RE

.PP
.RS

.nf
# podman pod stats \-\-no\-stream \-\-format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
ID             NAME           MEM USAGE / LIMIT
6eae9e25a564   clever\_bassi   3.031MB / 16.7GB

.fi
.RE

.SH SEE ALSO
.PP
podman\-pod(1), podman(1)

.SH HISTORY
.PP
February 2019, Originally compiled by Dan Walsh dwalsh@redhat.com
\[la]mailto:dwalsh@redhat.com\[ra]