1podman-stats(1)() podman-stats(1)()
2
3
4
6 podman-stats - Display a live stream of one or more container's
7 resource usage statistics
8
9
11 podman stats [options] [container]
12
13
14 podman container stats [options] [container]
15
16
18 Display a live stream of one or more containers' resource usage statis‐
19 tics
20
21
22 Note: Podman stats will not work in rootless environments that use
23 CGroups V1. Podman stats relies on CGroup information for statistics,
24 and CGroup v1 is not supported for rootless use cases.
25
26
27 Note: Rootless environments that use CGroups V2 are not able to report
28 statistics about their networking usage.
29
30
32 --all, -a
33
34
35 Show all containers. Only running containers are shown by default
36
37
38 --latest, -l
39
40
41 Instead of providing the container name or ID, use the last created
42 container. If you use methods other than Podman to run containers such
43 as CRI-O, the last started container could be from either of those
44 methods.
45
46
47 The latest option is not supported on the remote client.
48
49
50 --no-reset
51
52
53 Do not clear the terminal/screen in between reporting intervals
54
55
56 --no-stream
57
58
59 Disable streaming stats and only pull the first result, default setting
60 is false
61
62
63 --format=template
64
65
66 Pretty-print container statistics to JSON or using a Go template
67
68
69 Valid placeholders for the Go template are listed below:
70
71
72 ┌────────────┬───────────────────┐
73 │Placeholder │ Description │
74 ├────────────┼───────────────────┤
75 │.Pod │ Pod ID │
76 ├────────────┼───────────────────┤
77 │.ID │ Container ID │
78 ├────────────┼───────────────────┤
79 │.Name │ Container Name │
80 ├────────────┼───────────────────┤
81 │.CPU │ CPU percentage │
82 ├────────────┼───────────────────┤
83 │.MemUsage │ Memory usage │
84 ├────────────┼───────────────────┤
85 │.Mem │ Memory percentage │
86 ├────────────┼───────────────────┤
87 │.NetIO │ Network IO │
88 ├────────────┼───────────────────┤
89 │.BlockIO │ Block IO │
90 ├────────────┼───────────────────┤
91 │.PIDS │ Number of PIDs │
92 └────────────┴───────────────────┘
93
94 When using a GO template, you may precede the format with table to
95 print headers.
96
97
99 # podman stats -a --no-stream
100 ID NAME CPU % MEM USAGE / LIMIT MEM % NET IO BLOCK IO PIDS
101 a9f807ffaacd frosty_hodgkin -- 3.092MB / 16.7GB 0.02% -- / -- -- / -- 2
102 3b33001239ee sleepy_stallman -- -- / -- -- -- / -- -- / -- --
103
104
105
106 # podman stats --no-stream a9f80
107 ID NAME CPU % MEM USAGE / LIMIT MEM % NET IO BLOCK IO PIDS
108 a9f807ffaacd frosty_hodgkin -- 3.092MB / 16.7GB 0.02% -- / -- -- / -- 2
109
110
111
112 # podman stats --no-stream --format=json a9f80
113 [
114 {
115 "id": "a9f807ffaacd",
116 "name": "frosty_hodgkin",
117 "cpu_percent": "--",
118 "mem_usage": "3.092MB / 16.7GB",
119 "mem_percent": "0.02%",
120 "netio": "-- / --",
121 "blocki": "-- / --",
122 "pids": "2"
123 }
124 ]
125
126
127
128 # podman stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
129 ID NAME MEM USAGE / LIMIT
130 6eae9e25a564 clever_bassi 3.031MB / 16.7GB
131
132
133
135 podman(1)
136
137
139 July 2017, Originally compiled by Ryan Cole rycole@redhat.com
140 ⟨mailto:rycole@redhat.com⟩
141
142
143
144 podman-stats(1)()