1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl top node - Display Resource (CPU/Memory) usage of nodes
10
14 kubectl top node [OPTIONS]
15
19 Display Resource (CPU/Memory) usage of nodes.
20 The top-node command allows you to see the resource consumption of
23 nodes.
24
28 --no-headers=false If present, print output without headers
29 -l, --selector="" Selector (label query) to filter on, supports
32 '=', '==', and '!='.(e.g. -l key1=value1,key2=value2)
33 --sort-by="" If non-empty, sort nodes list using specified field.
36 The field can be either 'cpu' or 'memory'.
37 --use-protocol-buffers=false If present, protocol-buffers will be
40 used to request metrics.
41
45 --add-dir-header=false If true, adds the file directory to the
46 header of the log messages
47 --alsologtostderr=false log to standard error as well as files
50 --application-metrics-count-limit=100 Max number of application
53 metrics to store (per container)
54 --as="" Username to impersonate for the operation
57 --as-group=[] Group to impersonate for the operation, this flag
60 can be repeated to specify multiple groups.
61 --azure-container-registry-config="" Path to the file containing
64 Azure container registry configuration information.
65 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
68 list of files to check for boot-id. Use the first one that exists.
69 --cache-dir="/builddir/.kube/cache" Default cache directory
72 --certificate-authority="" Path to a cert file for the certificate
75 authority
76 --client-certificate="" Path to a client certificate file for TLS
79 --client-key="" Path to a client key file for TLS
82 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
85 CIDRs opened in GCE firewall for L7 LB traffic proxy health
86 checks
87 --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
90 CIDRs opened in GCE firewall for L4 LB traffic proxy health
91 checks
92 --cluster="" The name of the kubeconfig cluster to use
95 --container-hints="/etc/cadvisor/container_hints.json" location of
98 the container hints file
99 --containerd="/run/containerd/containerd.sock" containerd endpoint
102 --containerd-namespace="k8s.io" containerd namespace
105 --context="" The name of the kubeconfig context to use
108 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
111 tionSeconds of the toleration for notReady:NoExecute that is added by
112 default to every pod that does not already have such a toleration.
113 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
116 tionSeconds of the toleration for unreachable:NoExecute that is added
117 by default to every pod that does not already have such a toleration.
118 --disable-root-cgroup-stats=false Disable collecting root Cgroup
121 stats
122 --docker="unix:///var/run/docker.sock" docker endpoint
125 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
128 ronment variable keys matched with specified prefix that needs to be
129 collected for docker containers
130 --docker-only=false Only report docker containers in addition to
133 root stats
134 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
137 from docker info (this is a fallback, default: /var/lib/docker)
138 --docker-tls=false use TLS to connect to docker
141 --docker-tls-ca="ca.pem" path to trusted CA
144 --docker-tls-cert="cert.pem" path to client certificate
147 --docker-tls-key="key.pem" path to private key
150 --enable-load-reader=false Whether to enable cpu load reader
153 --event-storage-age-limit="default=0" Max length of time for which
156 to store events (per type). Value is a comma separated list of key val‐
157 ues, where the keys are event types (e.g.: creation, oom) or "default"
158 and the value is a duration. Default is applied to all non-specified
159 event types
160 --event-storage-event-limit="default=0" Max number of events to
163 store (per type). Value is a comma separated list of key values, where
164 the keys are event types (e.g.: creation, oom) or "default" and the
165 value is an integer. Default is applied to all non-specified event
166 types
167 --global-housekeeping-interval=1m0s Interval between global house‐
170 keepings
171 --housekeeping-interval=10s Interval between container housekeep‐
174 ings
175 --insecure-skip-tls-verify=false If true, the server's certificate
178 will not be checked for validity. This will make your HTTPS connections
179 insecure
180 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
183 quests.
184 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
187 trace
188 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
191 sor container
192 --log-dir="" If non-empty, write log files in this directory
195 --log-file="" If non-empty, use this log file
198 --log-file-max-size=1800 Defines the maximum size a log file can
201 grow to. Unit is megabytes. If the value is 0, the maximum file size is
202 unlimited.
203 --log-flush-frequency=5s Maximum number of seconds between log
206 flushes
207 --logtostderr=true log to standard error instead of files
210 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
213 Comma-separated list of files to check for machine-id. Use the
214 first one that exists.
215 --match-server-version=false Require server version to match
218 client version
219 -n, --namespace="" If present, the namespace scope for this CLI
222 request
223 --one-output=false If true, only write logs to their native sever‐
226 ity level (vs also writing to each lower severity level)
227 --password="" Password for basic authentication to the API server
230 --profile="none" Name of profile to capture. One of
233 (none|cpu|heap|goroutine|threadcreate|block|mutex)
234 --profile-output="profile.pprof" Name of the file to write the
237 profile to
238 --referenced-reset-interval=0 Reset interval for referenced bytes
241 (container_referenced_bytes metric), number of measurement cycles after
242 which referenced bytes are cleared, if set to 0 referenced bytes are
243 never cleared (default: 0)
244 --request-timeout="0" The length of time to wait before giving up
247 on a single server request. Non-zero values should contain a corre‐
248 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
249 out requests.
250 -s, --server="" The address and port of the Kubernetes API server
253 --skip-headers=false If true, avoid header prefixes in the log
256 messages
257 --skip-log-headers=false If true, avoid headers when opening log
260 files
261 --stderrthreshold=2 logs at or above this threshold go to stderr
264 --storage-driver-buffer-duration=1m0s Writes in the storage driver
267 will be buffered for this duration, and committed to the non memory
268 backends as a single transaction
269 --storage-driver-db="cadvisor" database name
272 --storage-driver-host="localhost:8086" database host:port
275 --storage-driver-password="root" database password
278 --storage-driver-secure=false use secure connection with database
281 --storage-driver-table="stats" table name
284 --storage-driver-user="root" database username
287 --tls-server-name="" Server name to use for server certificate
290 validation. If it is not provided, the hostname used to contact the
291 server is used
292 --token="" Bearer token for authentication to the API server
295 --update-machine-info-interval=5m0s Interval between machine info
298 updates.
299 --user="" The name of the kubeconfig user to use
302 --username="" Username for basic authentication to the API server
305 -v, --v=0 number for the log level verbosity
308 --version=false Print version information and quit
311 --vmodule= comma-separated list of pattern=N settings for
314 file-filtered logging
315 --warnings-as-errors=false Treat warnings received from the server
318 as errors and exit with a non-zero exit code
319
323 # Show metrics for all nodes
324 kubectl top node
325 # Show metrics for a given node
327 kubectl top node NODE_NAME
328
333 kubectl-top(1),
334
338 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
339 com) based on the kubernetes source material, but hopefully they have
340 been automatically generated since!
341Manuals User KUBERNETES(1)(kubernetes)