治理和可观察性
Codex gives enterprise teams visibility into adoption and impact, plus the auditability needed for security and compliance programs. Use the self-serve dashboard for day-to-day tracking, the Analytics API for programmatic reporting, and the Compliance API to export detailed logs into your governance stack.
跟踪 Codex 使用情况的方法
根据您的需要,可以通过三种方式监控 Codex 使用情况:
分析仪表板:快速查看采用、使用和代码审查影响。
分析 API:将结构化每日指标拉入您的数据仓库或 BI 工具。
合规性 API:导出详细的活动日志以供审核、监控和调查。
分析仪表板
仪表板视图
分析仪表板 允许 ChatGPT 工作区管理员和分析查看者跟踪 Codex 的采用、使用和代码审查反馈。使用数据最多可能滞后 12 小时。
Codex provides date-range controls for daily and weekly views. Key charts include:
按产品面划分的活跃用户,包括 CLI、IDE 扩展、云、桌面和代码审查
工作空间和个人使用情况细分,包括按产品表面或型号划分的信用和代币使用情况
客户的螺纹和匝数产品活动
用户排名表,带有客户端过滤器和排序选项,例如积分、线程、回合、文本标记和当前连胜
代码审查活动,包括审查的 PR、按优先级排列的问题、评论、回复、反应和反馈情绪
当您的工作区具有这些功能时,技能调用、代理身份使用和访问令牌使用
数据导出
管理员还可以以 CSV 或 JSON 格式导出 Codex 分析数据。 Codex 提供以下导出选项:
工作空间使用情况,包括按表面划分的每日活跃用户数、线程数、轮数和积分
每个用户的使用情况,包括每日线程、回合和跨表面的积分,在允许的情况下可以使用可选的电子邮件地址
代码审查详细信息,包括每日评论、反应、回复和 priority-level 结果
分析 API
当您想要自动生成报告、构建内部仪表板或将 Codex 指标与现有工程数据结合时,请使用 Analytics API。
它衡量什么
企业分析 API 每天或每周返回工作区的 UTC 存储桶。它支持 workspace-level 和 per-user 使用、per-client 故障、代码审查吞吐量、代码审查评论优先级以及用户与代码审查评论的互动。
端点
基本 URL 是 https://api.chatgpt.com/v1/analytics/codex. 所有端点都返回带有 has_more 和 next_page 的分页页面对象。
使用 start_time 表示报告窗口开始时的包含 Unix 时间戳,使用 end_time 表示报告窗口结束时的独占 Unix 时间戳,使用 group_by 表示天或周存储桶、页面大小限制以及从上一个响应继续的页面。请求最多可追溯 90 天。
用法
GET /工作区/{workspace_id}/用法
返回每日或每周存储桶中线程、圈数、积分和 per-client 使用情况的总计。
省略组以返回 per-user 行。
设置 group=workspace 以返回 workspace-wide 行。
包括文本输入、缓存输入和输出令牌字段。
代码审查活动
GET /工作区/{workspace_id}/code_reviews
返回 Codex 完成的拉取请求审核。
返回 Codex 生成的评论总数。
按 P0、P1 和 P2 优先级细分评论。
用户参与代码审查
GET /工作区/{workspace_id}/code_review_responses
返回对 Codex 评论的回复和反应。
将反应分为积极反应、消极反应和其他反应。
统计收到反应、回复或任何形式参与的评论。
它是如何运作的
Analytics 使用时间窗口并支持日或周分组。结果是 time-ordered,并在带有 cursor-based 分页的页面中返回。使用范围为 codex.enterprise.analytics.read 的 API 密钥。
常见用例
工程可观测性仪表板
领导力更新的采用报告
使用治理和成本监控
合规性 API
当您需要安全、法律和治理工作流程的可审核记录时,请使用 合规性 API 。
它衡量什么
合规性 API 为企业提供了一种导出 Codex 活动日志和元数据的方法,以便您可以将该数据连接到现有的审核、监控和安全工作流程。它设计用于与 eDiscovery、DLP、SIEM 或其他合规系统等工具配合使用。
对于通过 ChatGPT 进行身份验证的 Codex 使用情况,合规性 API 导出提供 Codex 活动的审核记录,并可用于调查和合规性工作流程。这些审核日志最多保留 30 天。 API-key-authenticated Codex 的使用遵循您的 API 组织设置,并且不包含在合规性 API 导出中。
您可以导出什么
活动日志
发送至 Codex 的提示文本
生成响应 Codex
标识符,例如工作区、用户、时间戳和模型
令牌使用和相关请求元数据
用于审计和调查的元数据
使用记录元数据来回答以下问题:
谁运行了任务
谁创建或撤销了访问令牌
当它运行时
使用的是哪个型号
处理了多少内容
常见用例
安全调查
合规报告
政策执行审核
将事件路由到 SIEM 和电子数据展示管道
它不提供什么
生成的代码行(对生产力来说有点嘈杂,并且可能会激励错误的行为)
建议接受率(几乎100%,因为用户通常首先接受更改)
代码质量或性能 KPI
推荐图案
大多数企业结合使用:
用于 self-serve 监控和快速解答的分析仪表板
用于自动报告和 BI 集成的分析 API
用于审核出口和调查的合规 API