1KUBERNETES(1) Jan 2015 KUBERNETES(1)
2
3
4
6 kubectl top pod - Display Resource (CPU/Memory/Storage) usage of pods
7
8
9
11 kubectl top pod [OPTIONS]
12
13
14
16 Display Resource (CPU/Memory/Storage) usage of pods.
17
18
19 The 'top pod' command allows you to see the resource consumption of
20 pods.
21
22
23 Due to the metrics pipeline delay, they may be unavailable for a few
24 minutes since pod creation.
25
26
27
29 -A, --all-namespaces=false
30 If present, list the requested object(s) across all namespaces.
31 Namespace in current context is ignored even if specified with --names‐
32 pace.
33
34
35 --containers=false
36 If present, print usage of containers within a pod.
37
38
39 --heapster-namespace="kube-system"
40 Namespace Heapster service is located in
41
42
43 --heapster-port=""
44 Port name in service to use
45
46
47 --heapster-scheme="http"
48 Scheme (http or https) to connect to Heapster as
49
50
51 --heapster-service="heapster"
52 Name of Heapster service
53
54
55 --no-headers=false
56 If present, print output without headers.
57
58
59 -l, --selector=""
60 Selector (label query) to filter on, supports '=', '==', and
61 '!='.(e.g. -l key1=value1,key2=value2)
62
63
64 --sort-by=""
65 If non-empty, sort pods list using specified field. The field can
66 be either 'cpu' or 'memory'.
67
68
69
71 --alsologtostderr=false
72 log to standard error as well as files
73
74
75 --application-metrics-count-limit=100
76 Max number of application metrics to store (per container)
77
78
79 --as=""
80 Username to impersonate for the operation
81
82
83 --as-group=[]
84 Group to impersonate for the operation, this flag can be repeated
85 to specify multiple groups.
86
87
88 --azure-container-registry-config=""
89 Path to the file containing Azure container registry configuration
90 information.
91
92
93 --boot-id-file="/proc/sys/kernel/random/boot_id"
94 Comma-separated list of files to check for boot-id. Use the first
95 one that exists.
96
97
98 --cache-dir="/builddir/.kube/http-cache"
99 Default HTTP cache directory
100
101
102 --certificate-authority=""
103 Path to a cert file for the certificate authority
104
105
106 --client-certificate=""
107 Path to a client certificate file for TLS
108
109
110 --client-key=""
111 Path to a client key file for TLS
112
113
114 --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
115 CIDRs opened in GCE firewall for LB traffic proxy health checks
116
117
118 --cluster=""
119 The name of the kubeconfig cluster to use
120
121
122 --container-hints="/etc/cadvisor/container_hints.json"
123 location of the container hints file
124
125
126 --containerd="/run/containerd/containerd.sock"
127 containerd endpoint
128
129
130 --containerd-namespace="k8s.io"
131 containerd namespace
132
133
134 --context=""
135 The name of the kubeconfig context to use
136
137
138 --default-not-ready-toleration-seconds=300
139 Indicates the tolerationSeconds of the toleration for
140 notReady:NoExecute that is added by default to every pod that does not
141 already have such a toleration.
142
143
144 --default-unreachable-toleration-seconds=300
145 Indicates the tolerationSeconds of the toleration for unreach‐
146 able:NoExecute that is added by default to every pod that does not
147 already have such a toleration.
148
149
150 --docker="unix:///var/run/docker.sock"
151 docker endpoint
152
153
154 --docker-env-metadata-whitelist=""
155 a comma-separated list of environment variable keys that needs to
156 be collected for docker containers
157
158
159 --docker-only=false
160 Only report docker containers in addition to root stats
161
162
163 --docker-root="/var/lib/docker"
164 DEPRECATED: docker root is read from docker info (this is a fall‐
165 back, default: /var/lib/docker)
166
167
168 --docker-tls=false
169 use TLS to connect to docker
170
171
172 --docker-tls-ca="ca.pem"
173 path to trusted CA
174
175
176 --docker-tls-cert="cert.pem"
177 path to client certificate
178
179
180 --docker-tls-key="key.pem"
181 path to private key
182
183
184 --enable-load-reader=false
185 Whether to enable cpu load reader
186
187
188 --event-storage-age-limit="default=0"
189 Max length of time for which to store events (per type). Value is a
190 comma separated list of key values, where the keys are event types
191 (e.g.: creation, oom) or "default" and the value is a duration. Default
192 is applied to all non-specified event types
193
194
195 --event-storage-event-limit="default=0"
196 Max number of events to store (per type). Value is a comma sepa‐
197 rated list of key values, where the keys are event types (e.g.: cre‐
198 ation, oom) or "default" and the value is an integer. Default is
199 applied to all non-specified event types
200
201
202 --global-housekeeping-interval=1m0s
203 Interval between global housekeepings
204
205
206 --housekeeping-interval=10s
207 Interval between container housekeepings
208
209
210 --insecure-skip-tls-verify=false
211 If true, the server's certificate will not be checked for validity.
212 This will make your HTTPS connections insecure
213
214
215 --kubeconfig=""
216 Path to the kubeconfig file to use for CLI requests.
217
218
219 --log-backtrace-at=:0
220 when logging hits line file:N, emit a stack trace
221
222
223 --log-cadvisor-usage=false
224 Whether to log the usage of the cAdvisor container
225
226
227 --log-dir=""
228 If non-empty, write log files in this directory
229
230
231 --log-file=""
232 If non-empty, use this log file
233
234
235 --log-file-max-size=1800
236 Defines the maximum size a log file can grow to. Unit is megabytes.
237 If the value is 0, the maximum file size is unlimited.
238
239
240 --log-flush-frequency=5s
241 Maximum number of seconds between log flushes
242
243
244 --logtostderr=true
245 log to standard error instead of files
246
247
248 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
249 Comma-separated list of files to check for machine-id. Use the
250 first one that exists.
251
252
253 --match-server-version=false
254 Require server version to match client version
255
256
257 -n, --namespace=""
258 If present, the namespace scope for this CLI request
259
260
261 --password=""
262 Password for basic authentication to the API server
263
264
265 --profile="none"
266 Name of profile to capture. One of (none|cpu|heap|goroutine|thread‐
267 create|block|mutex)
268
269
270 --profile-output="profile.pprof"
271 Name of the file to write the profile to
272
273
274 --request-timeout="0"
275 The length of time to wait before giving up on a single server
276 request. Non-zero values should contain a corresponding time unit (e.g.
277 1s, 2m, 3h). A value of zero means don't timeout requests.
278
279
280 -s, --server=""
281 The address and port of the Kubernetes API server
282
283
284 --skip-headers=false
285 If true, avoid header prefixes in the log messages
286
287
288 --skip-log-headers=false
289 If true, avoid headers when opening log files
290
291
292 --stderrthreshold=2
293 logs at or above this threshold go to stderr
294
295
296 --storage-driver-buffer-duration=1m0s
297 Writes in the storage driver will be buffered for this duration,
298 and committed to the non memory backends as a single transaction
299
300
301 --storage-driver-db="cadvisor"
302 database name
303
304
305 --storage-driver-host="localhost:8086"
306 database host:port
307
308
309 --storage-driver-password="root"
310 database password
311
312
313 --storage-driver-secure=false
314 use secure connection with database
315
316
317 --storage-driver-table="stats"
318 table name
319
320
321 --storage-driver-user="root"
322 database username
323
324
325 --token=""
326 Bearer token for authentication to the API server
327
328
329 --update-machine-info-interval=5m0s
330 Interval between machine info updates.
331
332
333 --user=""
334 The name of the kubeconfig user to use
335
336
337 --username=""
338 Username for basic authentication to the API server
339
340
341 -v, --v=0
342 number for the log level verbosity
343
344
345 --version=false
346 Print version information and quit
347
348
349 --vmodule=
350 comma-separated list of pattern=N settings for file-filtered log‐
351 ging
352
353
354
356 # Show metrics for all pods in the default namespace
357 kubectl top pod
358
359 # Show metrics for all pods in the given namespace
360 kubectl top pod --namespace=NAMESPACE
361
362 # Show metrics for a given pod and its containers
363 kubectl top pod POD_NAME --containers
364
365 # Show metrics for the pods defined by label name=myLabel
366 kubectl top pod -l name=myLabel
367
368
369
370
372 kubectl-top(1),
373
374
375
377 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
378 com) based on the kubernetes source material, but hopefully they have
379 been automatically generated since!
380
381
382
383Eric Paris kubernetes User Manuals KUBERNETES(1)