skip to content

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#kubernetes

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.

#interview-prep

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

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.

#hiring

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.

#kubernetes

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.

#kubernetes