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

NAME

6       podman-pod-stats - Display a live stream of resource usage statistics
7       for the 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
17
18

OPTIONS

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

EXAMPLE

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

SEE ALSO

120       podman-pod(1), podman(1)
121
122

HISTORY

124       February 2019, Originally compiled by Dan Walsh ⟨dwalsh@redhat.com⟩
125
126
127
128                                                        podman-pod-stats (1"")