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

NAME

6       podman-stats - Display a live stream of 1 or more containers' resource
7       usage statistics
8
9

SYNOPSIS

11       podman stats [options] [container]
12
13

DESCRIPTION

15       Display a live stream of one or more containers' 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 container name or ID, use the last created
30       container. If you use methods other than Podman to run containers such
31       as CRI-O, the last started container could be from either of those
32       methods.
33
34
35       The latest option is not supported on the remote client.
36
37
38       --no-reset
39
40
41       Do not clear the terminal/screen in between reporting intervals
42
43
44       --no-stream
45
46
47       Disable streaming stats and only pull the first result, default setting
48       is false
49
50
51       --format="TEMPLATE"
52
53
54       Pretty-print container statistics to JSON or using a Go template
55
56
57       Valid placeholders for the Go template are listed below:
58
59
60       ┌────────────┬───────────────────┐
61       │Placeholder │ Description       │
62       ├────────────┼───────────────────┤
63       │.Pod        │ Pod ID            │
64       ├────────────┼───────────────────┤
65       │.CID        │ Container ID      │
66       ├────────────┼───────────────────┤
67       │.Name       │ Container Name    │
68       ├────────────┼───────────────────┤
69       │.CPU        │ CPU percentage    │
70       ├────────────┼───────────────────┤
71       │.MemUsage   │ Memory usage      │
72       ├────────────┼───────────────────┤
73       │.Mem        │ Memory percentage │
74       ├────────────┼───────────────────┤
75       │.NetIO      │ Network IO        │
76       ├────────────┼───────────────────┤
77       │.BlockIO    │ Block IO          │
78       ├────────────┼───────────────────┤
79       │.PIDS       │ Number of PIDs    │
80       └────────────┴───────────────────┘
81
82       When using a GO template, you may preceed the format with table to
83       print headers.
84
85

EXAMPLE

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

SEE ALSO

123       podman(1)
124
125

HISTORY

127       July 2017, Originally compiled by Ryan Cole ⟨rycole@redhat.com⟩
128
129
130
131                                                            podman-stats (1"")