1podman-pod-stats(1)()                                    podman-pod-stats(1)()
2
3
4

NAME

6       podman-pod-stats  -  Display  a live stream of resource usage stats for
7       containers in one or more pods
8
9

SYNOPSIS

11       podman pod stats [options] [pod]
12
13

DESCRIPTION

15       Display a live stream of containers in one or more pods resource  usage
16       statistics.  Running rootless is only supported on cgroups v2.
17
18

OPTIONS

20   --all, -a
21       Show all containers.  Only running containers are shown by default
22
23
24   --latest, -l
25       Instead of providing the pod name or ID, use the last created pod.
26
27
28       The latest option is not supported on the remote client.
29
30
31   --no-reset
32       Do not clear the terminal/screen in between reporting intervals
33
34
35   --no-stream
36       Disable  streaming  pod  stats  and only pull the first result, default
37       setting is false
38
39
40   --format=template
41       Pretty-print container statistics to JSON or using a Go template
42
43
44       Valid placeholders for the Go template are listed below:
45
46
47       ┌───────────────┬────────────────────┐
48       │Placeholder    │ Description        │
49       ├───────────────┼────────────────────┤
50       │.Pod           │ Pod ID             │
51       ├───────────────┼────────────────────┤
52       │.CID           │ Container ID       │
53       ├───────────────┼────────────────────┤
54       │.Name          │ Container Name     │
55       ├───────────────┼────────────────────┤
56       │.CPU           │ CPU percentage     │
57       ├───────────────┼────────────────────┤
58       │.MemUsage      │ Memory usage       │
59       ├───────────────┼────────────────────┤
60       │.MemUsageBytes │ Memory usage (IEC) │
61       ├───────────────┼────────────────────┤
62       │.Mem           │ Memory percentage  │
63       ├───────────────┼────────────────────┤
64       │.NetIO         │ Network IO         │
65       ├───────────────┼────────────────────┤
66       │.BlockIO       │ Block IO           │
67       ├───────────────┼────────────────────┤
68       │.PIDS          │ Number of PIDs     │
69       ├───────────────┼────────────────────┤
70       │               │                    │
71       └───────────────┴────────────────────┘
72
73       When using a GO template, you may precede  the  format  with  table  to
74       print headers.
75
76

EXAMPLE

78              # podman pod stats -a --no-stream
79              ID             NAME              CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
80              a9f807ffaacd   frosty_hodgkin    --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
81              3b33001239ee   sleepy_stallman   --      -- / --             --      -- / --   -- / --    --
82
83
84
85              # podman pod stats --no-stream a9f80
86              ID             NAME             CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
87              a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
88
89
90
91              # podman pod stats --no-stream --format=json a9f80
92              [
93                  {
94                      "id": "a9f807ffaacd",
95                      "name": "frosty_hodgkin",
96                      "cpu_percent": "--",
97                      "mem_usage": "3.092MB / 16.7GB",
98                      "mem_percent": "0.02%",
99                      "netio": "-- / --",
100                      "blocki": "-- / --",
101                      "pids": "2"
102                  }
103              ]
104
105
106
107              # podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
108              ID             NAME           MEM USAGE / LIMIT
109              6eae9e25a564   clever_bassi   3.031MB / 16.7GB
110
111
112

SEE ALSO

114       podman-pod(1), podman(1)
115
116

HISTORY

118       February  2019,  Originally  compiled  by  Dan  Walsh dwalsh@redhat.com
119       ⟨mailto:dwalsh@redhat.com⟩
120
121
122
123                                                         podman-pod-stats(1)()