Instrumentation & Tracing

Authentication issues in production can be notoriously difficult to debug.

To solve this, Authkestra is deeply instrumented with the tracing crate. Every major decision, protocol step, and logical branch emits a granular span or event.

Definition of Done

As part of our internal Definition of Done (DoD), every new feature in Authkestra must include adequate tracing instrumentation.

Viewing Logs

Simply initialize a tracing_subscriber in your application to see the rich logs generated by the engine.

tracing_subscriber::fmt()
    .with_max_level(tracing::Level::DEBUG)
    .init();

You’ll see exactly when tokens are exchanged, when sessions are created, and precise error reasons if an authentication flow fails.