%{
  description: "Runtime introspection, debug overrides, and diagnostic tooling for Jido agents.",
  title: "Debugging",
  category: :docs,
  legacy_paths: [],
  tags: [:docs, :reference],
  order: 300
}
---

Runtime debugging tools for inspecting agent state, tracing signal flow, and diagnosing issues in development and production.

## Jido.Debug

TODO: Document `Jido.Debug` runtime overrides — per-instance telemetry level changes, event buffering, persistent_term-based config.

## Debug events

TODO: Document `:off`, `:minimal`, `:all` modes and the in-process event buffer.

## IEx helpers

TODO: Document interactive debugging patterns — inspecting agent state, listing agents, tracing signals through the system.

## Next steps

- [Telemetry and observability](/docs/reference/telemetry-and-observability) - production monitoring and metrics
- [Configuration](/docs/reference/configuration) - debug-related config keys