koan-debugging

What problem does it solve?

Debugging complex framework-driven applications can be challenging, especially with auto-discovery and multi-provider architectures. This Skill provides targeted strategies and tools to quickly diagnose and resolve common issues in Koan Framework applications.

Core Features & Use Cases

• Boot Report Analysis: Leverage detailed startup logs to identify module loading issues, provider election problems, and configuration warnings.
• Targeted Troubleshooting: Address common problems like "service not found," "ID not generated," "query not working," and "wrong provider elected" with specific diagnostic steps and solutions.
• Performance Diagnostics: Identify and resolve N+1 query problems and out-of-memory errors using batch operations and streaming patterns.
• Container Debugging: Get guidance on troubleshooting container startup failures, networking issues, and health checks.
• Use Case: When your application fails to start or a data query behaves unexpectedly, use the boot report to pinpoint misconfigurations, verify provider capabilities, or identify missing service registrations.

Quick Start

To view detailed boot logs for your Koan application, run: docker logs koan-app --tail 20 --follow | grep "Koan:" In development, add this to Program.cs to dump a full snapshot: if (KoanEnv.IsDevelopment) { KoanEnv.DumpSnapshot(logger); }