blog / kubernetes
Kubernetes troubleshooting guides
Field guides for the failures that actually page you. CrashLoopBackOff, ImagePullBackOff, OOMKills, pending pods, broken Services, each with the fastest diagnostic path first.
17 posts
Posts
Kubernetes NetworkPolicy debugging: when pods can't talk
Kubernetes NetworkPolicy not working - or working too well? A test method for silent packet drops: default-deny surprises, selector typos, DNS egress.
PVC stuck in Pending and volume mount failures
A PVC stuck in Pending in Kubernetes: StorageClass typos, missing provisioners, WaitForFirstConsumer, access modes, and the mount failures that follow.
Requests and limits: the misconfigurations that page you
Kubernetes resource limits and requests, minus the folklore: CPU throttling, limit=request tradeoffs, missing requests, and the LimitRange safety net.
Ingress 502, 503, 504: which layer is lying to you
Kubernetes ingress 502, 503, and 504 errors decoded: which layer failed, which logs to read, and the fastest path from load balancer to pod to find it.
Evicted pods: node pressure and who gets killed first
Kubernetes pod evicted? How node-pressure eviction works, what the eviction message means, why QoS class decides who dies first, and how to clean up.
Debugging Kubernetes DNS: from nslookup to CoreDNS
Kubernetes DNS troubleshooting from symptom to CoreDNS: reproduce with a debug pod, decode the ndots trap, read CoreDNS logs, check upstream resolvers.
Rolling update stuck: maxUnavailable, PDBs, hung rollouts
Kubernetes rollout stuck? How to read rollout status, decode progressDeadlineExceeded, spot PDB deadlocks, and roll back without making it worse.
Node NotReady: what to check, in order
A Kubernetes node NotReady is a race against pod eviction. The ordered checklist: kubelet, CNI, certs, and node pressure - fastest check first.
HPA not scaling: metrics-server and the usual suspects
HPA not scaling? The ordered checklist: metrics-server health, missing resource requests, misread targets, behavior windows, and what the conditions mean.
Pod stuck in Pending: the complete diagnostic tree
Pod stuck in Pending? Kubernetes scheduler events decoded - insufficient resources, taints, affinity, PVC binding, quota, and the silent no-events case.
CreateContainerConfigError: fixing ConfigMap and Secret refs
CreateContainerConfigError decoded: every ConfigMap and Secret mistake that causes it, the exact describe events, and the fastest fix for each.
OOMKilled and exit code 137: finding the real memory hog
OOMKilled Kubernetes pods and exit code 137: how to read Last State, use kubectl top, dodge JVM container traps, and decide raise-the-limit vs fix-the-leak.
How to prepare for a Kubernetes troubleshooting interview
Kubernetes interview preparation that actually works: what troubleshooting interviews test, a weekly practice loop, and the command fluency list to drill.
Kubernetes pod status reference: every state and its cause
Every Kubernetes pod status, from Pending to Terminating: what each one means, which subsystem gave up, and the first command to run.
Kubernetes interview questions that actually predict skill
Most Kubernetes interview questions test vocabulary, not skill. Here are scenario questions that predict debugging ability, with strong and weak answers.
Fixing ImagePullBackOff: every cause, fastest check first
Every cause of kubernetes ImagePullBackOff, ordered fastest check first: image typos, missing tags, registry auth, Docker Hub rate limits, and network failures.
Debugging CrashLoopBackOff in Kubernetes: a field guide
What CrashLoopBackOff really means, how to read the exit code, and the 8 causes it comes from - each with the fastest diagnostic path first.