跨仪表板、API 和报表协调 Copilot 使用情况指标

Copilot 使用情况指标仪表板、API 和导出文件都使用相同的基础遥测数据，但它们聚合并呈现方式不同。 了解这些差异有助于协调各个源的数字，并在准备内部报表时信任分析。

先决条件

Copilot 使用情况指标取决于 来自用户 IDE 的遥测数据。 如果开发人员在其 IDE 中禁用了遥测数据，则其 Copilot 活动 不会 显示在仪表板、API 报表或导出的数据中。

如果你注意到缺少用户或意外的采用率较低，请先验证 IDE 遥测设置，然后再排查其他原因。

指标对齐

仪表板和 API 对关键指标使用共享定义：

概念	仪表盘指标	API 或导出字段	注释
活动用户	每日/每周/活动用户总数	user_initiated_interaction_count > 0	如果用户当天在 IDE 中与 Copilot 交互，则被视为活动。
接受率	代码完成验收率

          `code_acceptance_activity_count` ÷ `code_generation_activity_count` | 两个源都以相同的方式计算接受率，尽管舍入可能有所不同。 |

| 代理采用 | 代理使用情况图表 | totals_by_feature 当特性 = "代理" 时 | 反映与 Copilot 代理　交互的用户。 | | 语言的使用 | 语言使用情况图表 | totals_by_language_feature 或 totals_by_language_model | 仪表板可视化这些聚合字段。 |

有关完整的字段说明，请参阅 GitHub Copilot 使用情况指标。

报表之间的差异

表板数据、API 报告和导出文件之间存在小幅差异是正常的。 这些变化通常是由时间窗口、范围或数据新鲜度的差异引起的。

时间范围

每个数据源以不同的方式聚合数据。

来源	时间窗口	聚合方法
Dashboard	28 天滚动窗口	在过去的28天里，指标被持续聚合，以便平滑波动。
应用程序接口	Daily	每条记录代表每个用户的单日数据，以便进行每日趋势分析。
NDJSON 导出	Daily	为 BI 工具和长期报告提供 API 输出镜像。

将报告周期与仪表板的 28 天窗口保持一致，可确保进行一致的比较。

延迟遥测

由于 IDE 遥测以异步方式处理，因此最近几天的数据可能不完整或缺失。 数据通常在 3 个完整的 UTC 天内完成。 最近每日指标看似明显下降的问题通常在遥测数据完全处理后会得到解决。

导出时序

NDJSON 文件反映导出时可用的数据。 如果在处理新遥测数据之前下载了文件，则数据可能会滞后于仪表板或 API。 在三天窗口后重新导出文件可提供最准确的视图。

          `Unknown` 值

          `Unknown`当来自 IDE 客户端的遥测数据缺少足够的详细信息来对活动进行分类时，该值将显示在某些 API 或导出细分中。 这是预期行为，并不指示缺少数据。

明细	Explanation
语言	当 IDE 无法识别活动文件的编程语言时，显示为 Unknown。
功能 / 特点	在较旧的客户端发送泛型事件而不指定聊天模式（例如， chat_panel_unknown_mode）时显示。
型号	当事件缺少标识所使用的模型的信息时出现。 某些内部模型（例如，gpt-4o-mini）在用于非面向用户的操作（例如摘要或意图检测）时，可能会与Unknown同时出现。

          `Unknown` 值会从仪表板的可视化中排除，但会显示在 API 和 NDJSON 数据中，以确保数据完整。 随着用户升级到发送更丰富的遥测数据的较新的 IDE 和扩展版本，数据量 `Unknown` 会减少。