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       --disable-compression=false       If true, opt-out of response compres‐
67       sion for all requests to the server
68
69
70       --insecure-skip-tls-verify=false      If true, the server's certificate
71       will not be checked for validity. This will make your HTTPS connections
72       insecure
73
74
75       --kubeconfig=""      Path to the kubeconfig file to  use  for  CLI  re‐
76       quests.
77
78
79       --match-server-version=false        Require  server  version  to  match
80       client version
81
82
83       -n, --namespace=""      If present, the namespace scope  for  this  CLI
84       request
85
86
87       --password=""      Password for basic authentication to the API server
88
89
90       --profile="none"         Name   of   profile   to   capture.   One   of
91       (none|cpu|heap|goroutine|threadcreate|block|mutex)
92
93
94       --profile-output="profile.pprof"      Name of the  file  to  write  the
95       profile to
96
97
98       --request-timeout="0"       The length of time to wait before giving up
99       on a single server request. Non-zero values  should  contain  a  corre‐
100       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
101       out requests.
102
103
104       -s, --server=""      The address and port of the Kubernetes API server
105
106
107       --tls-server-name=""      Server name to  use  for  server  certificate
108       validation.  If  it  is  not provided, the hostname used to contact the
109       server is used
110
111
112       --token=""      Bearer token for authentication to the API server
113
114
115       --user=""      The name of the kubeconfig user to use
116
117
118       --username=""      Username for basic authentication to the API server
119
120
121       --version=false      Print version information and quit
122
123
124       --warnings-as-errors=false      Treat warnings received from the server
125       as errors and exit with a non-zero exit code
126
127
128

SEE ALSO

130       kubectl(1), kubectl-top-node(1), kubectl-top-pod(1),
131
132
133

HISTORY

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