---
title: "做治理和可观测"
description: "Codex 为 enterprise teams 提供两类能力："
verifiedAt: "2026-05-07"
---

> [!NOTE]
> **这一篇用 6 分钟换什么**：把 Codex 治理工具拆成**三层 + 三角色**——Analytics Dashboard（管理者快看）/ Analytics API（BI 拉数）/ Compliance API（安全审计）。读完后你不会把 Compliance API 当日常指标用，也不会把 dashboard 当成审计证据。

Codex 为 enterprise teams 提供两类能力：

- 看清 adoption 和 impact。
- 为 security 与 compliance programs 提供 auditability。

日常跟踪可以用 self-serve dashboard；需要程序化报表时用 Analytics API；需要把详细 logs 接入治理体系时用 Compliance API。

治理的目标不是用指标替代工程判断，而是回答三类问题：

1. 团队是否真的在使用 Codex。
2. Codex 是否对 review、cloud tasks、CLI/IDE adoption 产生可见影响。
3. 出现安全、合规或调查需求时，能否拿到可审计记录。

## Ways to Track Codex Usage

根据使用场景不同，Codex usage 可以通过三种方式监控：

| 方式 | 适合场景 |
|---|---|
| **Analytics Dashboard** | 快速查看 adoption 和 code review impact。 |
| **Analytics API** | 把 structured daily metrics 拉入 data warehouse 或 BI tools。 |
| **Compliance API** | 导出 detailed activity logs，用于 audit、monitoring 和 investigations。 |

## Analytics Dashboard

[https://developers.openai.com/images/codex/enterprise/analytics.png](https://developers.openai.com/images/codex/enterprise/analytics.png)

### Dashboards

[analytics dashboard](https://chatgpt.com/codex/settings/analytics) 允许 ChatGPT workspace administrators 跟踪 feature adoption。

Codex 提供下面这些 dashboards：

- Daily users by product，包括 CLI、IDE、cloud、Code Review。
- Daily code review users。
- Daily code reviews。
- Code reviews by priority level。
- Daily code reviews by feedback sentiment。
- Daily cloud tasks。
- Daily cloud users。
- Daily VS Code extension users。
- Daily CLI users。

### Data Export

Administrators 也可以把 Codex analytics data 导出为 CSV 或 JSON format。

Codex 提供下面这些 export options：

- Code review users and reviews：每天的 unique users，以及 Code Review 中 completed reviews total。
- Code review findings and feedback：comments、reactions、replies、priority-level findings 的 daily counts。
- cloud users and tasks：daily unique cloud users，以及 completed cloud tasks。
- CLI and VS Code users：Codex CLI 与 VS Code extension 的 daily unique users。
- Sessions and messages per user：跨 surfaces 统计每个 Codex user 的 daily session starts 和 user message counts。

## Analytics API

当你需要自动化 reporting、构建 internal dashboards，或把 Codex metrics 与现有 engineering data 合并时，使用 [Analytics API](https://chatgpt.com/codex/settings/apireference)。

### Analytics API Measures

Analytics API 为 workspace 提供 daily、time-series metrics，并支持 optional per-user breakdowns 和 per-client usage。

### Endpoints

#### Daily Usage and Adoption

- Daily totals for threads、turns 和 credits。
- Breakdown by client surface。
- Optional per-user reporting，用于 adoption 和 power-user analysis。

#### Code Review Activity

- Pull request reviews completed by Codex。
- Total comments generated by Codex。
- Severity breakdown of comments。

#### User Engagement with Code Review

- Replies to Codex comments。
- Reactions，包括 upvotes 和 downvotes。
- Engagement breakdowns，用来分析 teams 如何响应 Codex feedback。

### How It Works

Analytics 是 daily 和 time-windowed 的。

results 按时间排序，并通过 cursor-based pagination 分页返回。

你可以按 workspace 查询，也可以选择 group by user，或在 workspace level 做 aggregate。

### Common Use Cases

- Engineering observability dashboards。
- Adoption reporting for leadership updates。
- Usage governance and cost monitoring。

## Compliance API

当你需要 security、legal 和 governance workflows 所需的 auditable records 时，使用 [Compliance API](https://chatgpt.com/admin/api-reference)。

### Compliance API Measures

Compliance API 让 enterprises 可以导出 Codex activity 的 logs 和 metadata，并把这些数据接入已有 audit、monitoring 和 security workflows。

它面向 eDiscovery、DLP、SIEM 或其他 compliance systems 这类工具链。

对于通过 ChatGPT authenticated 的 Codex usage，Compliance API exports 会提供 Codex activity 的 audit records，可用于 investigations 和 compliance workflows。

这些 audit logs 最多保留 30 days。

通过 API key authenticated 的 Codex usage 遵循你的 API organization settings，不包含在 Compliance API exports 中。

### What You Can Export

#### Activity Logs

- Prompt text sent to Codex。
- Responses Codex generated。
- Identifiers，例如 workspace、user、timestamp 和 model。
- Token usage 以及 related request metadata。

#### Metadata for Audit and Investigation

record metadata 可以帮助回答这类问题：

- Who ran a task。
- When it ran。
- Which model was used。
- How much content was processed。

#### Common Use Cases

- Security investigations。
- Compliance reporting。
- Policy enforcement audits。
- Routing events into SIEM and eDiscovery pipelines。

### What It Does Not Provide

- Lines of code generated：这是 noisy productivity proxy，也可能诱导错误行为。
- Acceptance rate of suggestions：通常接近 100%，因为 users 往往先接受 change。
- Code quality 或 performance KPIs。

## Recommended Pattern

大多数 enterprises 会组合使用下面三类能力：

1. **Analytics Dashboard**：self-serve monitoring 和 quick answers。
2. **Analytics API**：automated reporting 和 BI integration。
3. **Compliance API**：audit exports 和 investigations。

## 落地架构建议

一个实用的治理方案通常这样分层：

| 层级 | owner | 频率 | 产出 |
|---|---|---|---|
| Team dashboard | engineering manager / platform owner | 每周 | adoption、code review usage、cloud tasks 趋势。 |
| BI warehouse | data / platform team | 每天 | user、client surface、credits、review activity 的结构化指标。 |
| Audit export | security / compliance | 按策略或事件 | prompt、response、metadata、token usage、investigation records。 |

不要把 Compliance API 当成日常产品指标来源。它的定位是 audit、monitoring、investigation、eDiscovery、DLP、SIEM 等治理链路。日常趋势和成本分析优先走 dashboard 或 Analytics API。

## 指标解释边界

这些指标要谨慎解读：

- Daily users 增加，不等于工程质量提高。
- Code review comments 增加，不等于真实问题增加。
- Credits 增加，可能是任务更复杂，也可能是 prompt/context 过重。
- CLI/IDE adoption 低，可能是 onboarding 或权限配置问题。
- Cloud tasks 少，可能是团队更偏本地开发，并不代表 Codex 没价值。

官方文档也明确：lines of code generated、suggestion acceptance rate、code quality 或 performance KPIs 不适合作为 Compliance API 提供的治理指标。它们要么噪声大，要么容易诱导错误行为。

## 数据边界

需要特别说明：

- Compliance API exports 对 ChatGPT authenticated 的 Codex usage 提供 audit records。
- API key authenticated 的 Codex usage 遵循 API organization settings，不包含在 ChatGPT Compliance API exports 中。
- 详细 audit logs 有保留期限限制，现有正文按官方文档记录为最多 30 days。
- Prompt text、responses、workspace/user/timestamp/model、token usage 等都可能进入 audit record，团队要提前告知成员数据处理边界。

## 官方资料

- [Governance and Observability](https://developers.openai.com/codex/enterprise/governance#governance-and-observability)
- [Analytics dashboard](https://chatgpt.com/codex/settings/analytics)
- [Analytics API](https://chatgpt.com/codex/settings/apireference)
- [Compliance API](https://chatgpt.com/admin/api-reference)

## 接下来去哪

<Cards>
  <Card title="Enterprise Admin" href="/docs/codex/official/06-team-integration/54-enterprise-admin" description="把治理与组织管理一起设计" />
  <Card title="Managed Config" href="/docs/codex/official/06-team-integration/55-managed-config" description="集中下发执行边界配置" />
  <Card title="AI-Native Team" href="/docs/codex/official/06-team-integration/59-ai-native-team" description="adoption 数据怎么读出真实价值" />
  <Card title="GitHub Code Review" href="/docs/codex/official/06-team-integration/60-github-code-review" description="dashboards 的 code review impact 来源" />
  <Card title="安全运行时" href="/docs/codex/official/02-config-security/73-secure-runtime" description="Compliance API 之外的另一条安全路径" />
</Cards>
