Kubernetes Troubleshooting

When to Use This Skill

Use this skill when:

• Pods are failing, crashing, or stuck pending
• Services are unreachable
• DNS resolution isn't working
• Resource pressure (CPU/memory) issues
• PVCs not binding
• General cluster health concerns

Diagnostic Discipline (MANDATORY)

1. Prove the server path first. Check pod health, logs, and upstream deps BEFORE suggesting client-side causes.
2. Cached success is not proof. DNS caches, stale metrics, and HTTP caches can mask failures. Use tools that bypass caches.
3. Check every layer. One green light doesn't prove the layers behind it are healthy.

Quick Diagnostics