Agent 系统的调试和监控一直是工程化的薄弱环节。传统方法依赖 Agent 输出的文本日志和人工阅读对话记录来排查问题。OpenTelemetry 社区发布的新 Agent 可观测性扩展从根本上改变了这一状况。核心能力包括三个模块。Agent Trace：将用户请求、Agent 思考步骤、工具调用和模型响应串联为一个完整的 trace，每个 span 记录了步骤 ID、输入输出摘要和耗时。Tool Call Profiling：每个工具调用独立成 span，记录调用参数、返回结果、耗时和错误信息，支持按工具名称、耗时和调用次数聚合分析。Decision Path Visualization：Agent 的决策链路（包括分支选择、回退和重试）以可视化的 DAG（有向无环图）形式呈现，支持按时间轴回放。
在《从零到精通 Agent Harness》课程中，可观测性被定义为生产级 Agent 系统的三大基础设施之一（另外两个是认证授权和状态持久化）。学习者应当理解：没有可观测性的 Agent 系统就像一个没有仪表盘的飞机——虽然可以飞，但一旦出问题无法定位故障。课程推荐在 Agent Harness 中集成 OpenTelemetry SDK，通过以下方式降低接入门槛：利用 MCP 协议的 initialize 阶段注入 trace 上下文；在每个 tool call 前后自动创建 OpenTelemetry span；将 trace 数据导出到 Jaeger 或 Grafana Tempo 等后端。