Skip to main content

 ๐Ÿ”ฅ Kubernetes Troubleshooting Made Simple! ๐Ÿ”ฅ

Managing workloads on Kubernetes can be tricky — but with the right commands, you can cut debugging time in half. 

Here’s a practical cheatsheet ๐Ÿ› ️ for engineers, SREs, and DevOps teams:


1️⃣ Confirm Cluster & Namespace

 ⚡ kubectl config current-context → check context

 ⚡ kubectl get ns → list namespaces

 ⚡ kubectl get pods -n <namespace> → list pods


2️⃣ Get the Big Picture

 ๐Ÿ“Œ kubectl get nodes → nodes

 ๐Ÿ“Œ kubectl get pods -A → all pods

 ๐Ÿ“Œ kubectl get deployments -A → deployments

 ๐Ÿ“Œ kubectl get events -A --sort-by=.metadata.creationTimestamp → recent events


3️⃣ Inspect Failing Pods

 ๐Ÿ” kubectl describe pod <pod> -n <ns>

 ๐Ÿ“œ kubectl logs <pod> -n <ns>

 ๐Ÿ’ก kubectl exec -it <pod> -n <ns> -- /bin/sh


4️⃣ Probes & Health Checks

 ๐Ÿฉบ Readiness & liveness probes → check with kubectl describe

 ๐Ÿฉบ Test endpoint inside pod:

 kubectl exec -it <pod> -n <ns> -- curl -sv localhost:<port>/health


5️⃣ Rollouts, History & Recovery

 ⏳ kubectl rollout status deployment/<name> -n <ns>

 ๐Ÿ“œ kubectl rollout history deployment/<name> -n <ns>

 ๐Ÿ”„ kubectl rollout undo deployment/<name> -n <ns>


6️⃣ Networking & Services

 ๐ŸŒ kubectl get svc -n <ns> → list services

 ๐Ÿ”— kubectl get endpoints -n <ns> → check endpoints

 ๐Ÿงญ kubectl exec -it <pod> -n <ns> -- nslookup <service> → DNS test

 ๐Ÿšช kubectl port-forward svc/<svc> 8080:80 -n <ns> → local test


7️⃣ Storage Debugging

 ๐Ÿ’พ kubectl get pvc -n <ns> → list PVCs

 ๐Ÿ“‚ kubectl describe pvc <pvc> -n <ns> → inspect PVC

 ⚠️ Look for mount errors in pod describe


8️⃣ Resources, Logs & Quick Fixes

 ๐Ÿ“Š kubectl top nodes / kubectl top pods -n <ns> → usage

 ๐Ÿ“œ Use stern/kubetail → tail logs across pods

 ๐Ÿ”„ kubectl rollout restart deployment/<name> -n <ns>

 ๐Ÿ”„ kubectl delete pod <pod> -n <ns> → recreate pod

๐Ÿ’ก Save this post for your next K8s firefight. Troubleshooting doesn’t have to feel like guesswork — it’s about following a structured checklist.

Comments