Buglyst Blog
Learn to debug under pressure.
Playbooks for fast pattern recognition, guides for the full investigation, and articles for the engineering judgment around the edges.
17 playbooks · 509 guides · 95 articles · 12 linked practice labs ·skip to practice
Fast pattern recognition for the production failures engineers see most often.
2 playbooks in Infrastructure & Cloud
Debugging Env Var Issues
A concise checklist for incidents where local works but CI, staging, or production changes behavior.
Debugging Deployment Config Bugs
How to debug incidents where the source is deployment wiring rather than application logic.
Structured investigations for the failure modes engineers meet in real systems.
Node.js Self-Signed Certificate Error: Debugging TLS_CERTIFICATE_VERIFY_FAILED
A practical guide to diagnosing and fixing 'UNABLE_TO_VERIFY_LEAF_SIGNATURE' and 'SELF_SIGNED_CERT_IN_CHAIN' errors in Node.js HTTPS requests.
Node.js DNS Lookup Failure: How to Debug Resolution Timeouts and ENOTFOUND
A practical guide to debugging Node.js DNS resolution failures, including ENOTFOUND, EAI_AGAIN, and timeout errors in production.
Debugging Python boto3 AWS API Errors: A Field Guide
A practical guide to diagnosing and fixing boto3 API errors in Python, covering credential issues, throttling, and service-specific failures.
Debugging Kubernetes Pod OOMKilled: Beyond the Memory Limit
A hands-on guide to diagnosing and fixing OOMKilled pods in Kubernetes, covering cgroup pressure, memory limits, and hidden memory consumers.
Kubernetes Pod Stuck in Pending: Debugging Resource and Scheduling Failures
A practical guide to diagnosing why a Kubernetes pod remains in Pending state, covering resource constraints, node affinity, taints, and PVC issues with real commands.
Kubernetes Service Not Reachable from Pod: Debugging Ingress, DNS & Network Policies
A practical guide to debugging why a Kubernetes Service is unreachable from within another Pod, covering DNS resolution, network policies, and endpoint health.
Long-form thinking on debugging habits, observability, and the systems around the bug.
Chaos Engineering at 3 AM: When Our Kubernetes Cluster Lost Its DNS
We ran a chaos experiment on our Kubernetes cluster and found a subtle DNS misconfiguration that would have caused a cascading failure. Here's how we did it and what we learned.
Debugging Inside Docker Containers: Tools, Techniques, and a War Story
Practical techniques for debugging inside Docker containers: exec, nsenter, strace, and a real incident that made me rethink debug images.
kubectl logs: Debugging Pods with Logs, Timestamps, and Previous Instances
Beyond `kubectl logs pod-name` — using timestamps, previous instances, and multi-container patterns to diagnose real failures.
Debugging Serverless Functions Locally: A Practical Approach
Local debugging of serverless functions requires different tools and mindset than traditional apps. Here's how I approach it with real examples.
Debugging Terraform and CloudFormation Errors: A Field Guide to the 3 AM Page
Infrastructure-as-code errors are inevitable. Here's how to systematically debug Terraform and CloudFormation failures without losing your mind.