观测云正式支持 Codex 可观测

随着 AI 编程工具不断演进，无论是 OpenAI Codex ，Claude Code 或其他，越来越多的开发者开始让 AI 参与代码编写、测试、自动执行开发任务。

为了帮助企业更好地管理和观察 AI Coding Agent 的运行情况，观测云 Agent 观测新增 Codex 可观测能力，让 AI 编程智能体也能够纳入统一可观测体系。

一、Codex 需要可观测

OpenAI Codex 正在改变软件开发。全到自主执行多文件修改、运行测试、提交 PR ... Codex 的能力边界快速扩展。能力越强也带来了更多不确定性，比如：

• 一次任务可能触发多轮模型调用、工具执行，Token 消耗会随上下文、调用轮次和重试情况变化
• 代码生成过程中读取了哪些文件？执行了哪些命令？为什么选择了某个实现方案？
• 是否访问了敏感文件？是否越权执行了高危操作？内容是否符合安全策略？

观测云 Agent 观测基于 OpenTelemetry 标准，将 Codex 已采集上报的执行记录组织为 Session → Trace → Span 的层级结构，具体覆盖范围取决于接入方式、版本和采集配置。

二、观测云针对 Codex 的观测能力

1、Session 级会话追踪

按采集到的任务标识将相关记录聚合为 Session，可查看已上报的信息：

• 起止时间：任务开始到结束的全周期
• 对话轮次：用户与 Codex 的交互次数
• Trace 数量：任务触发的子执行链路数
• Token 消耗：已上报的输入/输出 Token 及成本估算；估算不等同于服务商最终账单
• 风险事件：采集记录中识别出的敏感操作、越权访问等风险；监测不等同于自动阻断，也不会授予工具执行权限

2、Trace 瀑布图，看清 Agent 执行

下钻到单次执行链路，通过瀑布图查看 Codex 已上报的执行记录；按实际采集情况可包含：

• 请求上下文：用户指令与已记录的交互信息，不代表模型内部的私有推理过程
• 上下文读取：Codex 读取了哪些文件、目录结构
• 模型请求：每次调用的模型版本、Prompt 长度、响应耗时
• 工具执行：文件写入、命令执行、测试运行、Git 操作
• 结果输出：生成的代码 diff、提交信息、PR 链接

Span 的耗时、Token 数、状态和 Input/Output 内容以实际采集字段为准。Codex 内置适配器支持 none、preview、full 内容采集模式及字符长度限制；未上报、未启用内容采集或已截断的内容不会自动补齐。

三、立即接入

在「观测云控制台 → Agent 监测 → Summary」的 Agent 页签点击「接入 Agent」，选择「Codex」，按页面提示配置 User 身份并在 Codex 所在主机安装 obs-agent-connector。通过 obs-agent-connector agents 确认当前版本与操作系统支持，再执行 obs-agent-connector discover 完成接入；Codex 使用内置 Stop Hook 适配器，Connector 会处理相应的信任与配置。发起一次任务后检查是否收到数据，具体步骤见新建 Agent 监测应用。

立刻使用观测云，让你的AI智能体可观测。