Observability and Tracing

TeaQL Rust integrates deeply with the tracing ecosystem.

Current generated workspaces obtain audit, SQL, tool, sink, and schema settings from teaql-tool-core. Use TEAQL_AUDIT, TEAQL_SQL, TEAQL_TOOL, TEAQL_SINK, and TEAQL_SCHEMA for that path. The similarly named TEAQL_AUDIT_LOG, TEAQL_SQL_LOG, and TEAQL_TOOL_LOG variables belong to a separate formatter compatibility layer in teaql-runtime; they are not aliases. See the Environment Variables reference for exact values, defaults, filters, and validation behavior.

Setup

Enable the tracing subscriber in your main.rs:

tracing_subscriber::fmt::init();

The subscriber makes emitted TeaQL spans visible. Confirm the exact fields with the generated/runtime version in use; the environment-variable audit layer and the tracing subscriber are related observability surfaces, not the same configuration mechanism.

Tokio Console

For deep inspection of async tasks, you can use tokio-console to track down suspended tasks or potential async deadlocks caused by holding locks across .await points.