Copilot 使用指标的仪表板、API 和导出文件均使用相同的底层遥测数据，但它们的聚合和呈现方式不同。了解这些差异有助于在各来源之间对齐数据，并在编写内部报告时对分析结果保持信任。
- Copilot 使用指标仪表板可在 企业 和 组织 级别使用。
- Copilot 使用指标 API 支持 企业、组织和用户级别 的记录。
先决条件
基于 IDE 的 Copilot 使用指标依赖于 用户 IDE 的遥测。如果开发者在其 IDE 中禁用了遥测，则其基于 IDE 的 Copilot 活动将 不会 出现在仪表板、API 报告或导出数据中。
如果您发现用户缺失或采用率异常低，请先检查 IDE 遥测设置，再排查其他原因。
Copilot CLI 指标（daily_active_cli_users 和 totals_by_cli）与 IDE 遥测分开收集和报告。CLI 使用 不会 计入基于 IDE 的活跃用户数或其他 IDE 指标。
指标对齐
仪表板和 API 使用共享的关键指标定义
| 概念 | 仪表板指标 | API 或导出字段 | 注意 |
|---|---|---|---|
| 活跃用户 | 每日/每周/总计活跃用户 | user_initiated_interaction_count > 0 | 如果用户在该日与其 IDE 中的 Copilot 产生交互，则视为活跃用户。 |
| 接受率 | 代码补全接受率 | code_acceptance_activity_count ÷ code_generation_activity_count | 两个来源的接受率计算方式相同，唯一差别可能在于四舍五入。 |
| Agent 采纳 | 代理采用图表 | totals_by_feature，其中 feature = “agent” | 反映与 Copilot 代理交互的用户。 |
| 语言使用 | 语言使用图表 | totals_by_language_feature 或 totals_by_language_model | 仪表板对这些聚合字段进行可视化展示。 |
欲获取完整字段说明，请参阅 GitHub Copilot 使用指标。
报告之间的差异
仪表板数据、API 报告和导出之间存在细微差异是正常的。这些差异通常由时间窗口、范围或数据新鲜度的不同引起。
时间窗口
每个数据源的聚合方式各不相同。
| 来源 | 时间窗口 | 聚合方式 |
|---|---|---|
| 仪表板 | 28 天滚动窗口 | 指标在过去 28 天内持续聚合，以平滑波动。 |
| API | 每日 | 每条记录对应用户单日数据，便于进行每日趋势分析。 |
| NDJSON 导出 | 每日 | 复制 API 输出，用于商业智能工具和长期报告。 |
将报告周期与仪表板的 28 天窗口保持一致，可确保比较结果的一致性。
延迟的遥测
由于 IDE 遥测是异步处理的，最近几天的数据可能出现不完整或缺失。数据通常在完整的三个 UTC 天后确定。最近每日指标的明显下降往往在遥测全部处理完毕后恢复。
导出时机
NDJSON 文件反映导出时可用的数据。如果在新遥测处理之前下载文件，数据可能会落后于仪表板或 API。三天窗口后重新导出文件可获得最准确的视图。
Unknown 值
当 IDE 客户端的遥测信息不足以对活动进行分类时，某些 API 或导出细分中会出现值 Unknown。这是预期行为，并不表示数据缺失。
| 细分 | 说明 |
|---|---|
| 语言 | 当 IDE 无法识别活动文件的编程语言时，以 Unknown 显示。 |
| 功能 | 当旧版客户端发送未指定聊天模式的通用事件时出现（例如 chat_panel_unknown_mode）。 |
| 模型 | 当事件缺少标识所使用模型的信息时出现。部分内部模型（例如 gpt-4o-mini）在用于非面向用户的操作（如摘要或意图检测）时，可能与 Unknown 一同出现。 |
Unknown 值在仪表板可视化中被排除，但会出现在 API 和 NDJSON 数据中以保证完整性。随着用户升级到发送更丰富遥测的新版 IDE 和扩展，Unknown 数据的数量会减少。