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.
18 playbooks · 512 guides · 97 articles · 13 linked practice labs ·skip to practice
Fast pattern recognition for the production failures engineers see most often.
1 playbook in Observability & Performance
Service reliability · from symptoms to evidence
Microsoft 365 outage debugging
Separate Outlook symptoms from service impact, understand Graph retry timing, and follow queued email through acceptance and delivery. Read the guides, then practise the failure patterns in two simulated labs.
Structured investigations for the failure modes engineers meet in real systems.
Debugging LCP: Largest Contentful Paint Too Slow
A practical guide to diagnosing and fixing slow Largest Contentful Paint in real-world web applications, with specific commands, metrics, and war stories.
Debugging Cumulative Layout Shift (CLS): A Production Engineer's Guide
This guide provides concrete steps to diagnose and fix CLS issues in production, with real commands and specific tools.
JavaScript Long Task Blocking Main Thread: Diagnosis and Fixes
A practical guide to identifying and fixing JavaScript long tasks that block the browser's main thread, causing jank and poor user experience.
Debugging High Interaction to Next Paint (INP) Scores
A practical guide to diagnosing and fixing poor Interaction to Next Paint (INP) scores, covering event handler delays, rendering bottlenecks, and real-user monitoring.
Debugging JavaScript Garbage Collection Pauses That Kill Responsiveness
Learn how to identify and fix long GC pauses in Node.js and browser JavaScript using Chrome DevTools, Node --trace-gc, and heap snapshots.
OpenTelemetry Traces Not Appearing: Debugging Missing Spans in Production
A debugging guide for when OpenTelemetry traces are not appearing in your observability backend. Covers common and non-obvious causes like sampling misconfiguration, exporter timeouts, and context propagation failures.
Long-form thinking on debugging habits, observability, and the systems around the bug.
Adding Observability to a 500K-Line Monolith Without a Rewrite
Adding structured logging, distributed tracing, and metrics to a legacy monolith without a full rewrite. Real code examples and a war story from a 500K-line codebase.
Distributed Tracing: Following a Single Request Across Microservices
Distributed tracing lets you follow a request as it hops across services. I'll show you how trace context propagates, why sampling matters, and how tracing helped us debug a 5-second latency spike in production.
Structured Logging in JSON: Fields, Schemas, and Pitfalls from Production
A practical guide to designing JSON log schemas that are queryable, consistent, and actually useful in production — with field recommendations and a war story.
Sentry Error Monitoring: A Practical Setup Guide from a Production Outage
A step-by-step setup guide for Sentry error monitoring, covering source maps, release tracking, grouping rules, and alerting — with a real story of a production outage that taught us the hard way.
Reading Prometheus Alert Rules: A Practical Reference for Debugging Firing Alerts
Alert rules look straightforward until you're staring at a firing alert at 3 AM. This post covers the structure, common traps, and how to extract actionable intent from any rule.
Profiling SQL Queries: Finding and Fixing the Slow 5%
Profiling SQL queries is more than running EXPLAIN. This guide covers practical techniques to find the slowest queries, interpret execution plans, and fix them — with real examples from PostgreSQL and MySQL.