kubectl-top-node(1)

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

NAME

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

SYNOPSIS

14       kubectl top node [OPTIONS]
15
16
17

DESCRIPTION

19       Display resource (CPU/memory) usage of nodes.
20
21
22       The  top-node  command  allows  you  to see the resource consumption of
23       nodes.
24
25
26

OPTIONS

28       --no-headers=false      If present, print output without headers
29
30
31       -l, --selector=""      Selector (label query) to  filter  on,  supports
32       '=', '==', and '!='.(e.g. -l key1=value1,key2=value2). Matching objects
33       must satisfy all of the specified label constraints.
34
35
36       --show-capacity=false      Print node resources based on  Capacity  in‐
37       stead of Allocatable(default) of the nodes.
38
39
40       --sort-by=""       If non-empty, sort nodes list using specified field.
41       The field can be either 'cpu' or 'memory'.
42
43
44       --use-protocol-buffers=true      Enables using protocol-buffers to  ac‐
45       cess Metrics API.
46
47
48

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

144                # Show metrics for all nodes
145                kubectl top node
146
147                # Show metrics for a given node
148                kubectl top node NODE_NAME
149
150
151
152

HISTORY

159       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
160       com)  based  on the kubernetes source material, but hopefully they have
161       been automatically generated since!
162
163
164
165Manuals                              User            KUBERNETES(1)(kubernetes)