Skip to content

kx top

Lists pod or node CPU and memory usage with kubectl top, assigns indexes, and shows CPU%/MEM% — computed against each pod’s limits for pods, native to kubectl for nodes.

Unrecognized flags are passed through to kubectl.

Usage

kx top [OPTIONS] [resource] [kubectl flags]

Arguments

ArgumentDescription
[resource]pods (the default) or nodes

Options

OptionDescription
-A, --all-namespacesList pods across every namespace; each row is indexed and carries its own namespace. Not for nodes, which are not in a namespace
--htmlRender the listing as HTML and serve it in a browser
--jsonPrint the listing as JSON instead of a table
-m, --match stringMatch by name (substring, case-insensitive)
-n, --namespace stringNamespace to list pods from; defaults to the current namespace. Not for nodes, which are not in a namespace
--no-limitsSkip the CPU%/MEM% columns (one fewer kubectl call)
--no-openServe the HTML report without opening a browser
--out stringWrite the HTML report to this file instead of serving it in a browser
--port intPort to serve the HTML report on; 0 picks a free one

Global options

OptionDescription
--no-colorDisable styled output
-h, --helpShow this message and exit

Examples

kx top
kx top nodes
kx top -m web
kx top --no-limits
kx top --html
kx top --json
kx top --out top.html