Codex 为企业团队提供对采用情况和影响的可见性,以及安全和合规项目所需的可审计能力。你可以使用自助仪表板做日常跟踪,使用 Analytics API 做程序化报表,并通过 Compliance API 将详细日志导出到你现有的治理栈中。
跟踪 Codex 使用情况的方式
根据你的目标不同,可以通过三种方式监控 Codex 使用情况:
- Analytics Dashboard:快速查看采用情况以及代码审查带来的影响
- Analytics API:把结构化的每日指标拉取到你的数据仓库或 BI 工具中
- Compliance API:导出详细活动日志,用于审计、监控和调查
分析仪表板
仪表板
分析仪表板(analytics dashboard) 可供 ChatGPT 工作区管理员跟踪功能采用情况。
Codex 提供以下仪表板:
- 按产品划分的每日用户数(CLI、IDE、cloud、Code Review)
- 每日代码审查用户数
- 每日代码审查次数
- 按优先级划分的代码审查结果
- 按反馈情感划分的每日代码审查数据
- 每日 cloud 任务数
- 每日 cloud 用户数
- 每日 VS Code 扩展用户数
- 每日 CLI 用户数
数据导出
管理员还可以将 Codex 分析数据导出为 CSV 或 JSON。Codex 提供以下导出项:
- 代码审查用户与审查次数:Code Review(代码评审)中每日唯一用户数和总完成审查数
- 代码审查发现与反馈:评论、reaction、回复以及按优先级划分的发现数量
- 云端用户与任务:每日唯一云端用户数和完成任务数
- CLI 与 VS Code 用户:Codex CLI 和 VS Code 扩展的每日唯一用户数
- 每位用户的会话与消息:跨使用表面的每日会话启动次数和用户消息计数
Analytics API
当你需要自动化报表、搭建内部仪表板,或把 Codex 指标与现有工程数据联结时,请使用 Analytics API。
它衡量什么
Analytics API 为工作区提供按天聚合的时序指标,并可选支持按用户拆分和按客户端使用情况拆分。
端点
每日用量与采用情况
- 每日 threads、turns 和 credits 总数
- 按客户端表面拆分的使用情况
- 可选的按用户报表,用于采用分析和重度用户分析
代码审查活动
- Codex 完成的 pull request review 数量
- Codex 生成的评论总数
- 评论按严重级别的拆分
用户与代码审查的互动
- 对 Codex 评论的回复
- 各类 reactions,包括赞同和反对
- 团队如何响应 Codex 反馈的互动拆分
工作方式
Analytics 是按日、按时间窗口工作的。结果按时间排序,并通过基于 cursor 的分页返回。你可以按工作区查询,也可以选择按用户分组,或直接获取工作区级聚合结果。
常见用例
- 工程可观测性仪表板
- 面向管理层更新的采用情况报表
- 使用治理与成本监控
Compliance API
当你需要可审计记录来支持安全、法务和治理流程时,请使用 Compliance API。
它衡量什么
Compliance API 让企业能够导出 Codex 活动的日志与元数据,以便接入你现有的审计、监控和安全工作流。它适合与 eDiscovery、DLP、SIEM 或其他合规系统集成。
对于通过 ChatGPT 认证的 Codex 使用,Compliance API 导出会提供 Codex 活动的审计记录,可用于调查和合规流程。这些审计日志最多保留 30 天。通过 API key 认证的 Codex 使用遵循你所在 API 组织的设置,不会出现在 Compliance API 导出中。
你可以导出什么
活动日志
- 发送给 Codex 的 prompt 文本
- Codex 生成的响应
- 工作区、用户、时间戳和模型等标识信息
- token 用量及相关请求元数据
用于审计与调查的元数据
你可以利用这些记录元数据回答如下问题:
- 谁运行了某个任务
- 任务是在什么时候运行的
- 使用了哪个模型
- 处理了多少内容
常见用例
- 安全调查
- 合规报表
- 策略执行审计
- 将事件路由到 SIEM 和 eDiscovery 流水线
它不提供什么
- 生成了多少行代码:这只是一个噪声较大的生产力代理指标,而且可能激励错误行为
- 建议接受率:这个指标通常接近 100%,因为用户往往会先接受变更
- 代码质量或性能 KPI
推荐组合
大多数企业会组合使用以下三者:
- Analytics Dashboard:用于自助监控和快速获取结论
- Analytics API:用于自动化报表和 BI 集成
- Compliance API:用于审计导出和调查
来源:https://developers.openai.com/codex/enterprise/governance