debugging-and-observability

Diagnose production failures using systematic debugging, structured logging, and OpenTelemetry observability patterns.

1|Updated Aug 10, 2026
One-click install
npx skills add https://github.com/TheViziusGroup/vibe-engineering-skills --skill debugging-and-observability-theviziusgroup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-observability
Source: https://github.com/TheViziusGroup/vibe-engineering-skills/tree/main/plugins/quality-engineering/skills/debugging-and-observability
Command: npx skills add https://github.com/TheViziusGroup/vibe-engineering-skills --skill debugging-and-observability-theviziusgroup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Production bugs are hard to reproduce, distributed failures are hard to trace, and ad-hoc debugging wastes hours. This Skill provides a systematic, evidence-based methodology for debugging, logging, error handling, and observability so engineers can find root causes faster and build systems that explain themselves. ## Core Features & Use Cases - Systematic Debugging Methodology: Applies Agans' nine rules, delta debugging, git bisect, and reproducibility techniques to isolate failures with evidence instead of guesswork. - Observability Stack Guidance: Covers OpenTelemetry instrumentation, structured logging frameworks (slog, Pino, Serilog, structlog), the four signals (logs, metrics, traces, profiling), eBPF zero-instrumentation, and SLO-based burn-rate alerting. - Resilience and Error Handling: Implements retries with jitter, circuit breakers, bulkheads, RFC 9457 problem details, and language-specific patterns for Python, TypeScript/JavaScript, Go, Java, and .NET. - Use Case: A microservices outage shows error spikes across three services. Use this Skill to propagate correlation IDs, query distributed traces to locate the failing span, apply burn-rate alerting to page correctly, and add a circuit breaker to stop the cascade. ## Quick Start Help me debug a production latency spike in my Python microservice using structured logging, correlation IDs, and OpenTelemetry tracing.

Frequently Asked Questions about debugging-and-observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a production issue I cannot reproduce locally?

Build a minimum reproducible example by pinning exact failure conditions: inputs, environment, timing, concurrency, and data state. Use correlation IDs and structured logs from production to reconstruct the event sequence, then bisect the search space with git bisect or delta debugging.

What structured logging library should I use for Python, Node.js, or Go?

Use structlog or loguru for Python, Pino for Node.js (roughly 7x faster than Winston), and log/slog for Go since Go 1.21. For hot paths in Go, zap or zerolog offer lower allocation overhead.

How does OpenTelemetry help with distributed tracing?

OpenTelemetry provides unified traces, metrics, logs, and profiling with zero-code auto-instrumentation for Java, Python, and Node.js. It propagates W3C TraceContext headers across services so every log record carries trace and span IDs for log-to-trace correlation.

When should I use a circuit breaker versus retries?

Use retries with exponential backoff and full jitter for transient errors like 429, 503, or network timeouts on idempotent operations. Add a circuit breaker when a dependency fails persistently, so you stop hammering it and prevent cascade failures and resource exhaustion.

Can AI tools reliably find root causes of production incidents?

Not yet. The OpenRCA benchmark shows the best models solved only 11-36% of real root-cause cases, and Veracode found 45% of AI-generated code introduced OWASP Top 10 vulnerabilities. Use AI for triage, localization, and first-draft fixes, but gate everything behind tests and human review.

What is SLO-based burn-rate alerting and why use it?

Burn-rate alerting pages based on how fast you consume your error budget rather than raw error counts. Google's multi-window approach pages at roughly 14.4x burn over a 1-hour window and tickets at 6x over 6 hours, reducing both missed incidents and alert fatigue.