{"enrichment":{"faq":[{"a":"Debugging guides you through Turso's toolkit for tracking down database problems. Start by enabling trace logging with RUST_LOG to inspect core component behavior, then use bytecode comparison between SQLite and Turso to isolate code generation bugs from VM execution issues. For threading problems, run stress tests with ThreadSanitizer enabled. Deterministic simulation with seeds helps reproduce elusive bugs consistently.","q":"How to debug turso database issues effectively?"},{"a":"Debugging's bytecode comparison approach lets you diff the compiled instructions between SQLite and Turso to pinpoint where code generation diverges. This technique separates genuine VM execution bugs from incorrect query compilation. By comparing bytecode output for the same query, you can identify whether a problem stems from how Turso generates instructions or how it executes them.","q":"What's the bytecode comparison method for SQLite vs Turso?"},{"a":"Debugging recommends running stress tests with ThreadSanitizer enabled to catch threading bugs in Turso. ThreadSanitizer detects data races and synchronization issues that emerge under concurrent load. Combine this with stress testing to reproduce race conditions reliably, then use the sanitizer's output to locate the exact code paths causing threading problems.","q":"How do I use ThreadSanitizer for turso stress testing?"},{"a":"Debugging supports deterministic simulation using seeds to reproduce elusive bugs consistently. By seeding the concurrent simulator, you lock in a specific execution order that triggered a failure, making it reproducible across test runs. This eliminates the randomness that makes threading and timing bugs hard to catch, letting you reliably trigger and fix the problem.","q":"How can deterministic simulation with seeds help debug turso?"},{"a":"Debugging includes tools for analyzing database corruption and WAL integrity problems in Turso. These tools help diagnose storage layer failures and detect when write-ahead logs become corrupted. Use them alongside trace logging and bytecode comparison to understand whether corruption stems from code generation errors, VM bugs, or storage layer issues.","q":"What tools does debugging provide for turso corruption analysis?"},{"a":"Debugging enables query execution tracing through RUST_LOG environment variable configuration. Set RUST_LOG to trace level to capture detailed logs from Turso's core components, parser, AST processing, and VM execution. This reveals the full path a query takes through the system, helping you spot where execution diverges from expected behavior or where performance degrades.","q":"How do I trace turso query execution with RUST_LOG?"}],"shadow_tags":["bytecode-analysis","query-execution","concurrency-testing","database-corruption","sqlite-compatibility","deterministic-replay","thread-safety","storage-debugging"],"summary_rewrite":"This guide walks through Turso's debugging toolkit for tracking down database problems. Compare bytecode between SQLite and Turso to pinpoint code generation bugs versus VM issues, enable trace logging for core components, run stress tests with ThreadSanitizer to catch threading problems, and use deterministic simulation with seeds to reproduce elusive bugs. Corruption debugging tools help diagnose WAL and integrity failures."},"files":[{"bytes":1914,"path":".claude/skills/debugging/SKILL.md","sha256":"8a94146144a2f567cb9f123a758c849a1cbe1899e6f1243055cdeafac7d224f6","url":"https://skillfed.io/files/tursodatabase/turso/debugging/d9bb9f08/SKILL.md"}],"id":"tursodatabase/turso/debugging","links":{"html":"https://skillfed.io/tursodatabase/turso/debugging","md":"https://skillfed.io/tursodatabase/turso/debugging.md","repo":"https://github.com/tursodatabase/turso"},"meta":{"agents_supported":["claude-code"],"first_seen":"2026-07-28","forks":1211,"language":"Rust","last_updated":"2026-07-28","license":"MIT","name":"debugging","publisher":"tursodatabase","stars":23479},"relations":{"similar":[{"id":"tursodatabase/turso/differential-fuzzer"},{"id":"tursodatabase/turso/storage-format"},{"id":"tursodatabase/turso/testing"},{"id":"tursodatabase/agent-skills/turso-db"},{"id":"tursodatabase/turso/transaction-correctness"},{"id":"itechmeat/llm-code/turso"},{"id":"tursodatabase/turso/mvcc"},{"id":"mohitmishra786/low-level-dev-skills/rust-sanitizers-miri"},{"id":"tursodatabase/turso/pr-workflow"},{"id":"tursodatabase/turso/cdc"}]},"slug":{"owner":"tursodatabase","repo":"turso","skill":"debugging"},"version":"d9bb9f08"}