1KUBERNETES(1)(kubernetes)                            KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7

NAME

9       kubectl top - Display resource (CPU/memory) usage
10
11
12

SYNOPSIS

14       kubectl top [OPTIONS]
15
16
17

DESCRIPTION

19       Display Resource (CPU/Memory) usage.
20
21
22       The top command allows you to see the resource consumption for nodes or
23       pods.
24
25
26       This command requires Metrics Server to  be  correctly  configured  and
27       working on the server.
28
29
30

OPTIONS INHERITED FROM PARENT COMMANDS

32       --as=""      Username to impersonate for the operation. User could be a
33       regular user or a service account in a namespace.
34
35
36       --as-group=[]      Group to impersonate for the  operation,  this  flag
37       can be repeated to specify multiple groups.
38
39
40       --as-uid=""      UID to impersonate for the operation.
41
42
43       --azure-container-registry-config=""       Path  to the file containing
44       Azure container registry configuration information.
45
46
47       --cache-dir="/builddir/.kube/cache"      Default cache directory
48
49
50       --certificate-authority=""      Path to a cert file for the certificate
51       authority
52
53
54       --client-certificate=""      Path to a client certificate file for TLS
55
56
57       --client-key=""      Path to a client key file for TLS
58
59
60       --cluster=""      The name of the kubeconfig cluster to use
61
62
63       --context=""      The name of the kubeconfig context to use
64
65
66       --insecure-skip-tls-verify=false      If true, the server's certificate
67       will not be checked for validity. This will make your HTTPS connections
68       insecure
69
70
71       --kubeconfig=""       Path  to  the  kubeconfig file to use for CLI re‐
72       quests.
73
74
75       --match-server-version=false       Require  server  version  to   match
76       client version
77
78
79       -n,  --namespace=""       If  present, the namespace scope for this CLI
80       request
81
82
83       --password=""      Password for basic authentication to the API server
84
85
86       --profile="none"        Name   of   profile   to   capture.   One    of
87       (none|cpu|heap|goroutine|threadcreate|block|mutex)
88
89
90       --profile-output="profile.pprof"       Name  of  the  file to write the
91       profile to
92
93
94       --request-timeout="0"      The length of time to wait before giving  up
95       on  a  single  server  request. Non-zero values should contain a corre‐
96       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
97       out requests.
98
99
100       -s, --server=""      The address and port of the Kubernetes API server
101
102
103       --tls-server-name=""       Server  name  to  use for server certificate
104       validation. If it is not provided, the hostname  used  to  contact  the
105       server is used
106
107
108       --token=""      Bearer token for authentication to the API server
109
110
111       --user=""      The name of the kubeconfig user to use
112
113
114       --username=""      Username for basic authentication to the API server
115
116
117       --version=false      Print version information and quit
118
119
120       --warnings-as-errors=false      Treat warnings received from the server
121       as errors and exit with a non-zero exit code
122
123
124

SEE ALSO

126       kubectl(1), kubectl-top-node(1), kubectl-top-pod(1),
127
128
129

HISTORY

131       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
132       com)  based  on the kubernetes source material, but hopefully they have
133       been automatically generated since!
134
135
136
137Manuals                              User            KUBERNETES(1)(kubernetes)