This matrix lists common debugging goals and the corresponding settings or actions to achieve them. It also includes notes on the impact of each setting:
Goal Settings Notes
See request and tool call flow runtime.middleware.logging.enabled=true Provides base visibility
Add latency metrics runtime.middleware.timing.enabled=true Low overhead
Machine-parseable root logs logging.json=true Enables JSON for all loggers
Structured request events runtime.middleware.logging.structured=true Independent of root format
Enrichment annotation lines openapi_logging.annotations=true Adds per-operation summary
Verbose enrichment detail openapi_logging.verbose=true Adds raw or truncated size information
Audit tool invocations runtime.middleware.audit.enabled=true Emits one JSON event per call
Outbound HTTP decisions logging.loggers.http.outbound=DEBUG Shows query normalization and retries
TLS or mTLS diagnostics logging.loggers.http.tls=DEBUG Displays certificate and key load and verification
Response guard actions logging.loggers.response_guard=INFO Logs block, trim, or warn events
Downstream client config keys logging.loggers.http.config=DEBUG Emits config keys and resolved default headers