治理与可观测性

Codex 为企业团队提供采用情况和影响力的可见性，以及安全与合规项目所需的审计能力。您可以使用自助服务仪表板进行日常跟踪，使用 Analytics API 进行程序化报告，并使用 Compliance API 将详细日志导出到您的治理堆栈中。

跟踪 Codex 使用情况的方法

根据您的需求，有三种方法可以监控 Codex 的使用情况

• 分析仪表板：快速了解采用率、使用情况和代码审查的影响。
• Analytics API：将结构化的每日指标提取到您的数据仓库或商业智能 (BI) 工具中。
• Compliance API：导出详细的活动日志，用于审计、监控和调查。

分析仪表板

仪表板视图

分析仪表板允许 ChatGPT 工作区管理员和分析查看者跟踪 Codex 的采用率、使用情况和代码审查反馈。使用数据最多可能有 12 小时的延迟。

Codex 提供日期范围控制，支持日视图和周视图。关键图表包括：

• 按产品界面分类的活跃用户，包括 CLI、IDE 扩展、云端、桌面和代码审查
• 工作区和个人使用情况细分，包括按产品界面或模型划分的额度和 Token 使用量
• 按客户端划分的线程和轮次的产品活动
• 用户排名表，支持按客户端筛选，并提供额度、线程、轮次、文本 Token 和当前连续使用天数等排序选项
• 代码审查活动，包括已审查的 PR、按优先级划分的问题、评论、回复、反馈反应和反馈情绪
• 当您的工作区启用相关功能时，可查看技能调用、代理身份使用和访问令牌使用情况

数据导出

管理员还可以以 CSV 或 JSON 格式导出 Codex 分析数据。Codex 提供以下导出选项：

• 工作区使用情况，包括每日活跃用户、线程、轮次以及按界面划分的额度消耗
• 每位用户的使用情况，包括各界面的每日线程、轮次和额度消耗，允许时可包含电子邮件地址
• 代码审查详细信息，包括每日评论、反应、回复和优先级发现

Analytics API

当您需要实现报告自动化、构建内部仪表板或将 Codex 指标与现有工程数据集成时，请使用 Analytics API。

衡量内容

企业级 Analytics API 返回工作区每日或每周的 UTC 数据桶。它支持工作区级别和用户级别的使用情况统计、按客户端划分的细分、代码审查吞吐量、代码审查评论优先级，以及用户与代码审查评论的互动情况。

端点

基础 URL 为 https://api.chatgpt.com/v1/analytics/codex。所有端点均返回带有 has_more 和 next_page 的分页 page 对象。

使用 start_time 表示报告窗口起始的包含性 Unix 时间戳，end_time 表示报告窗口结束的排他性 Unix 时间戳，group_by 指定 day（天）或 week（周）数据桶，limit 指定页面大小，page 用于从上一个响应继续请求。请求最长可回溯 90 天。

用量

GET /workspaces/{workspace_id}/usage

• 返回线程、轮次、额度和按客户端划分的使用情况总计，以天或周为单位。
• 省略 group 参数将返回按用户划分的行。
• 设置 group=workspace 以返回整个工作区的行。
• 包含文本输入、缓存输入和输出 Token 字段。

代码审查活动

GET /workspaces/{workspace_id}/code_reviews

• 返回 Codex 完成的代码审查请求。
• 返回 Codex 生成的评论总数。
• 按 P0、P1 和 P2 优先级对评论进行细分。

用户与代码审查的互动

GET /workspaces/{workspace_id}/code_review_responses

• 返回对 Codex 评论的回复和反应。
• 将反应细分为积极、消极和其他反应。
• 统计收到反应、回复或任何形式互动的评论数量。

它是如何工作的

分析功能使用时间窗口，支持按天或周分组。结果按时间排序，并通过基于游标的分页返回。请使用作用域为 codex.enterprise.analytics.read 的 API 密钥。

常见使用场景

• 工程可观测性仪表板
• 向领导层汇报采用情况
• 使用治理和成本监控

Compliance API

当您需要为安全、法律和治理工作流保留可审计记录时，请使用 Compliance API。

衡量内容

Compliance API 为企业提供了一种导出 Codex 活动日志和元数据的方法，以便您可以将该数据连接到现有的审计、监控和安全工作流中。它专为与电子发现 (eDiscovery)、数据丢失防护 (DLP)、安全信息和事件管理 (SIEM) 或其他合规系统等工具配合使用而设计。

对于通过 ChatGPT 进行身份验证的 Codex 使用，Compliance API 导出提供 Codex 活动的审计记录，可用于调查和合规工作流。这些审计日志最多保留 30 天。通过 API 密钥认证的 Codex 使用遵循您的 API 组织设置，不包含在 Compliance API 导出中。

您可以导出的内容

活动日志

• 发送给 Codex 的提示词文本
• Codex 生成的响应
• 标识符，如工作区、用户、时间戳和模型
• Token 使用量和相关的请求元数据

用于审计和调查的元数据

使用记录元数据来回答以下问题：

• 谁运行了任务
• 谁创建或撤销了访问令牌
• 运行时间
• 使用了哪个模型
• 处理了多少内容

常见使用场景

• 安全调查
• 合规性报告
• 策略执行审计
• 将事件路由到 SIEM 和电子发现流水线

未提供的内容

• 生成的代码行数（这作为生产力的衡量指标存在偏差，可能会诱导错误的行为）
• 建议的采纳率（由于用户通常会直接采纳更改，该指标几乎总是 100%）
• 代码质量或性能 KPI

推荐模式

大多数企业结合使用以下功能：

1. 分析仪表板：用于自助监控和快速查询
2. Analytics API：用于自动化报告和 BI 集成
3. Compliance API：用于审计导出和调查