Skip to main content
Get CPU and memory metrics for nodes, pods, and containers in your Kubernetes cluster.
The metrics server must be installed in your cluster for these commands to work. Most managed Kubernetes services (EKS, GKE) have it pre-installed.

Subcommands

nodes

Get CPU and memory metrics for all cluster nodes.
clanker k8s stats nodes [flags]
Flags
--sort-by
string
Sort by cpu or memory
-o, --output
string
default:"table"
Output format: table, json, or yaml
Examples
# Get node metrics
clanker k8s stats nodes
NAME                          CPU(cores)   CPU%   MEMORY(bytes)   MEMORY%
ip-10-0-1-100.ec2.internal    245m         12%    1456Mi          38%
ip-10-0-1-101.ec2.internal    189m         9%     1123Mi          29%
# Sort by CPU usage
clanker k8s stats nodes --sort-by cpu
# Get output as JSON
clanker k8s stats nodes -o json
[
  {
    "name": "ip-10-0-1-100.ec2.internal",
    "cpu": "245m",
    "cpuPercent": 12.3,
    "memory": "1456Mi",
    "memPercent": 38.2
  },
  {
    "name": "ip-10-0-1-101.ec2.internal",
    "cpu": "189m",
    "cpuPercent": 9.5,
    "memory": "1123Mi",
    "memPercent": 29.4
  }
]

pods

Get CPU and memory metrics for pods.
clanker k8s stats pods [flags]
Flags
-n, --namespace
string
default:"default"
Namespace to query
-A, --all-namespaces
boolean
Show pods from all namespaces
--sort-by
string
Sort by cpu or memory
-o, --output
string
default:"table"
Output format: table, json, or yaml
Examples
# Get pod metrics in default namespace
clanker k8s stats pods
NAME                    CPU(cores)   MEMORY(bytes)
nginx-abc123-xyz        5m           25Mi
redis-def456-uvw        12m          128Mi
# Get pod metrics from all namespaces
clanker k8s stats pods -A
NAMESPACE     NAME                    CPU(cores)   MEMORY(bytes)
default       nginx-abc123-xyz        5m           25Mi
default       redis-def456-uvw        12m          128Mi
kube-system   coredns-abc-123         3m           15Mi
kube-system   aws-node-xyz-789        15m          95Mi
# Get pod metrics from kube-system namespace
clanker k8s stats pods -n kube-system
# Sort by memory usage
clanker k8s stats pods --sort-by memory

pod

Get metrics for a specific pod and its containers.
clanker k8s stats pod [pod-name] [flags]
pod-name
string
required
Name of the pod to get metrics for
Flags
-n, --namespace
string
default:"default"
Namespace of the pod
--containers
boolean
Show per-container metrics
-o, --output
string
default:"table"
Output format: table, json, or yaml
Examples
# Get metrics for a specific pod
clanker k8s stats pod my-pod
NAME      CPU(cores)   MEMORY(bytes)
my-pod    45m          256Mi
# Get per-container metrics
clanker k8s stats pod my-pod --containers
POD       CONTAINER       CPU(cores)   MEMORY(bytes)
my-pod    app             35m          200Mi
my-pod    sidecar         10m          56Mi
# Get metrics from a specific namespace
clanker k8s stats pod my-pod -n kube-system

cluster

Get aggregated cluster-wide metrics.
clanker k8s stats cluster [flags]
Flags
-o, --output
string
default:"table"
Output format: table, json, or yaml
Examples
# Get cluster-wide metrics
clanker k8s stats cluster
Cluster Metrics
===============
Nodes: 2
Avg CPU Usage: 10.9%
Avg Memory Usage: 33.8%

NODE                           CPU          CPU%     MEMORY       MEM%
ip-10-0-1-100.ec2.internal     245m         12.3%    1456Mi       38.2%
ip-10-0-1-101.ec2.internal     189m         9.5%     1123Mi       29.4%
# Get cluster metrics as JSON
clanker k8s stats cluster -o json
{
  "nodeCount": 2,
  "totalCPU": "0m",
  "totalMemory": "0Mi",
  "avgCPUPercent": 10.9,
  "avgMemPercent": 33.8,
  "nodes": [
    {
      "name": "ip-10-0-1-100.ec2.internal",
      "cpu": "245m",
      "cpuPercent": 12.3,
      "memory": "1456Mi",
      "memPercent": 38.2
    },
    {
      "name": "ip-10-0-1-101.ec2.internal",
      "cpu": "189m",
      "cpuPercent": 9.5,
      "memory": "1123Mi",
      "memPercent": 29.4
    }
  ]
}

Build docs developers (and LLMs) love