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.
Kubernetes Pod Affinity Scheduling Not Placing: Debugging Why Pods Stay Pending
Pod affinity rules can prevent scheduling even when resources are available. This guide shows how to diagnose and fix pod affinity failures in Kubernetes.
Debugging AWS Lambda Cold Start Latency
A practical guide to diagnosing and fixing high cold start latency in AWS Lambda, covering code, config, and runtime issues.
AWS Lambda Function Timeout: Debugging and Fixing Cold Starts, Throttling, and Concurrency Issues
A practical guide to diagnosing and fixing AWS Lambda timeout errors, covering cold starts, VPC latency, and concurrency limits with real commands.
AWS CloudFront Serving Stale Content – Debugging Cache Invalidation Failures
A hands-on guide to diagnosing and fixing stale content served by CloudFront when cache invalidations don't work as expected.
ECS Task Definition Error: Why Your Container Won't Start
A focused guide for diagnosing ECS tasks stuck in provisioning or stop due to definition errors—image pull failures, IAM role misconfig, and resource limits.
AWS EventBridge Rule Not Triggering: Debugging Guide
A practical guide to diagnosing why an EventBridge rule isn't firing, covering event pattern mismatches, IAM misconfigurations, and throttling.
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.