Agent 出了错，最难的不是修，而是「复现」——你往往只知道结果错了，却不知道它在第几步、哪次工具调用、哪个分支上跑偏了。这正是可观测性要解决的问题。OpenTelemetry 给出的答案是三根支柱：traces（追踪一次请求/任务经过的完整链路）、metrics（对吞吐、延迟、token 消耗等做可聚合的度量）、logs（离散事件日志），三者用同一套上下文做关联。作为 CNCF 项目，它的规范用跨语言的方式定义、按语义化版本管理，意味着无论你的 Agent 是 Python、Go 还是 TypeScript 写的，都能用同一套语义上报和查询。Codex 文档把 Tracing 与 Observability and usage 单列，说明「可观测」已从加分项变成 Agent 平台的一等公民。
对《从零到精通 Agent Harness》的学习者，可观测性是「生产就绪」的第一道门槛：课程中会把「每个工具调用、每个子任务都有一条可关联的 trace」作为部署前的硬性要求——没有 trace，出了事就无法回溯，Agent 就成了无法追责的黑盒。OpenTelemetry 的跨语言标准给了你一个不必自造轮子的底座。对《从零上手 Codex》的学习者，起步阶段至少要学会两件事：看懂一次任务的 token 消耗与步骤轨迹，以及遇到失败时能从 trace 里定位到具体哪一步。可观测性不是「运维才关心」的事，而是每个 Agent 开发者的基本盘。