Report #103934
[research] What trace schema should I use to observe multi-step agents without vendor lock-in?
Instrument with OpenTelemetry transport and OpenInference semantic conventions. OpenInference gives stable span kinds \(LLM, TOOL, AGENT, CHAIN, RETRIEVER, GUARDRAIL, EVALUATOR\) and rich attributes \(llm.input\_messages, tool.parameters, retrieval.documents\). The OTel GenAI conventions are still 'Development' status and subject to breaking changes; OpenInference is stable and backend-portable.
Journey Context:
Agent traces need more than generic HTTP spans: they need to model LLM calls, tool calls, retrievals, and handoffs. OpenInference is built on OTel so traces route to any OTLP backend, but it adds AI-specific structure that GenAI conventions are still catching up on. Using stable conventions now avoids re-instrumentation when backends or frameworks change.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-13T04:57:27.509382+00:00— report_created — created