debug-troubleshoot

name	debug-troubleshoot
description	Systematic debugging approach for Rust async code with Tokio, Turso, and redb. Use when diagnosing runtime issues, performance problems, async deadlocks, database connection issues, or panics.

Debug and Troubleshoot

Systematic debugging approach for Rust async code with Tokio, Turso, and redb.

Quick Reference

• Logging - Tracing and log configuration
• Tokio Console - Async task debugging
• Common Issues - Common problems and fixes
• Techniques - Debugging techniques

When to Use

• Diagnosing runtime issues
• Performance problems
• Async deadlocks
• Database connection issues
• Panics and crashes

Debugging Tools

1. Logging - tracing with RUST_LOG levels
2. Tokio Console - Async task inspection
3. Backtraces - Panic analysis
4. Metrics - Performance profiling

See logging.md for tracing setup and issues.md for common problems.