Skip to main content

Kubernetes Scheduling Latency Benchmark

These benchmarks measure Kubernetes scheduling and pod-startup latency, throughput, and control-plane behavior as clusters grow in nodes, pods, and churn. They reveal the scale ceiling and whether constraint complexity or etcd is the bottleneck.

Kubernetes scheduling latency benchmarks measure how fast and reliably the cluster control plane decides where to run pods and how that performance holds up at scale. The scheduler watches for unscheduled pods, filters and scores candidate nodes against constraints, and binds each pod to a node. Under heavy churn or large clusters, this pipeline can become a bottleneck.

These benchmarks are essential for capacity planning, batch and CI workloads, and any environment where pods are created and destroyed rapidly.

What It Measures

Key metrics include scheduling latency (time from pod creation to a binding decision), pod startup latency (creation to running, which adds image pull and kubelet work), scheduling throughput (pods placed per second), and control-plane API call latency. Benchmarks also probe the practical scale limits in nodes and pods before SLOs degrade.

Methodology

Tooling such as kube-burner, Clusterloader2, or the scheduler's own performance suite creates large numbers of pods under controlled conditions and records timestamps from the API server and scheduler. Tests vary cluster size (nodes), pod density, and the complexity of scheduling constraints (affinity, anti-affinity, topology spread, taints, resource requests). Churn scenarios repeatedly create and delete pods to stress the watch and bind paths. The benchmark reports latency percentiles, throughput, and whether the official scalability SLOs (such as API call latency and pod startup thresholds) are met at each scale point. Etcd and API server resource usage are captured to locate the limiting component.

How to Interpret Results

Scheduling latency that stays flat as the cluster grows indicates a healthy control plane; a sharp rise reveals the scale ceiling for your configuration. Complex constraints (many affinity rules, fine-grained topology spread) increase scoring cost and lengthen latency, so compare against your real policy set. Distinguish scheduling latency from pod startup latency: slow startup is often dominated by image pulls and kubelet, not the scheduler. If API call latency climbs, the bottleneck is usually etcd or the API server rather than scheduling logic. Use the results to set realistic cluster size limits and to decide whether to shard clusters or tune the scheduler.

Limitations

Results are highly sensitive to control-plane sizing, etcd storage performance, and Kubernetes version, so numbers do not transfer across environments. Synthetic pods with trivial images understate real startup latency dominated by large image pulls. The official SLO thresholds assume specific test conditions that may not match production constraint complexity. Finally, benchmarks usually exercise one dimension at a time, while real clusters face concurrent scheduling, scaling, and rollout pressure that interact in ways a single-axis test cannot capture.