Report #2250
[research] Agent observability relies on fragmented custom logging making cross-run analysis impossible
Instrument agent runs using OpenTelemetry \(OTel\) spans with the GenAI semantic conventions. Map each agent step to a child span, and the full workflow to a trace.
Journey Context:
Custom print statements or provider-specific tracing lock you in and make it hard to correlate agent steps with traditional infrastructure like database queries triggered by the agent. OTel provides a vendor-agnostic standard, and the emerging GenAI semantic conventions allow you to unify LLM calls, tool executions, and orchestration logic into a single queryable trace backend.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T10:31:57.528051+00:00— report_created — created