随着 AI 编程工具不断演进，无论是 OpenAI Codex ，Claude Code 或其他，越来越多的开发者开始让 AI 参与代码编写、测试、自动执行开发任务。
为了帮助企业更好地管理和观察 AI Coding Agent 的运行情况，观测云 Agent 观测新增 Codex 可观测能力，让 AI 编程智能体也能够纳入统一可观测体系。
一、Codex 需要可观测
OpenAI Codex 正在改变软件开发。全到自主执行多文件修改、运行测试、提交 PR ... Codex 的能力边界快速扩展。能力越强也带来了更多不确定性，比如：
·一次任务可能触发多轮模型调用、工具执行，Token 消耗在同一功能下可能波动十倍
·代码生成过程中读取了哪些文件？执行了哪些命令？为什么选择了某个实现方案？
·是否访问了敏感文件？是否越权执行了高危操作？内容是否符合安全策略？
观测云 Agent 观测基于 OpenTelemetry 标准，将 Codex 的执行过程完整映射为 Session → Trace → Span 的层级结构，让每一次 Agent 行动都可见。
二、观测云针对 Codex 的观测能力
1、Session 级会话追踪
将一次完整的编码任务聚合为单个 Session，包含：
·起止时间：任务开始到结束的全周期
·对话轮次：用户与 Codex 的交互次数
·Trace 数量：任务触发的子执行链路数
·Token 消耗：总输入/输出 Token 及成本估算
·风险事件：敏感操作、越权访问等告警
2、Trace 瀑布图，看清 Agent 决策
下钻到单次执行链路，通过瀑布图精确还原 Codex 的决策过程，包含：
·意图解析：用户指令的语义理解
·上下文读取：Codex 读取了哪些文件、目录结构
·模型请求：每次调用的模型版本、Prompt 长度、响应耗时
·工具执行：文件写入、命令执行、测试运行、Git 操作
·结果输出：生成的代码 diff、提交信息、PR 链接
每个 Span 的耗时、Token 数、状态、Input/Output 内容全部可见。
三、立即接入
在「观测云控制台」-「Agent 监测」，点击右上角「接入 Agent」，选择「Codex」即可快速接入。
立刻使用观测云，让你的AI智能体可观测。
