GitHub Copilot 用量指标 API 新增遥测缺失与版本不达标标记

GitHub 于 2026 年 11 月 5 日更新 Copilot 用量指标 API，新增客户端遥测状态与版本达标情况字段。企业及组织级用户报表和汇总报表将显示哪些用户缺少遥测数据、哪些用户的 IDE 或扩展版本低于用量指标最低要求，以及每日受影响人数。

新增的按用户诊断字段

此次更新在企业和组织的用户报表中新增两个按用户字段。client_telemetry_present 表示当天是否收到该用户的客户端遥测；若为 false，说明 Copilot 观察到了用户活动，但没有从编辑器收到用量事件。usage_metrics_requirements 则列出该用户使用的每个 IDE 和 Copilot 扩展，并对照最低支持版本标记为已满足、未满足或未知。

这两个字段直接指向报表数据不完整的两个来源：遥测通道缺失和客户端版本过低。此前管理员只能看到活跃用户数，却难以判断为何部分用户的报表缺少细节。

按日汇总的受影响人数

在企业和组织的报表中，还新增两个每日计数。missing_client_telemetry_user_count 统计当天 client_telemetry_present 为 false 的用户数；below_usage_metrics_minimum_user_count 统计当天至少有一个 IDE 或扩展低于最低版本的用户数。

GitHub 特别说明，每个计数只覆盖单日，且同一用户可能同时被计入两个计数，因此不应把两个数字相加；也不应跨天累加计数来推算去重用户数。

缺失遥测的影响与常见原因

GitHub 说明，没有客户端遥测的用户仍会被计为活跃，但其报表会缺少代码行数、功能细分和模型细分等细节。常见原因包括编辑器或扩展版本过旧、IDE 遥测被关闭，以及代理或防火墙拦截事件上报。

新增字段的作用是让管理员看到受影响用户的数量和具体对象，从而有针对性地跟进，而不必为此提交支持工单。GitHub 同时指出，版本达标与遥测缺失是两个独立信号：用户可能满足所有版本最低要求，但仍因处于代理之后而缺少遥测。

适用范围、权限与数据边界

按用户字段出现在企业和组织的用户报表中，覆盖 1 天与 28 天两种周期；计数则出现在企业和组织的 1 天报表，以及 28 天报表的每个 day_totals 条目中。

这些字段面向企业所有者、企业账单管理员、组织所有者，以及拥有授予“查看 Copilot 指标”权限的自定义组织或企业角色的用户，同时要求启用 Copilot 用量指标策略。对于空值或被省略的值，GitHub 明确其含义是数据不可用，而非 false 或零；本次发布之前的日期没有对应数值。

知序观察

观察：这次更新把 Copilot 用量报表的“数据缺口”从后台问题变成了可查询的指标。对企业管理员而言，价值在于能区分活跃但数据不全的用户，并判断问题出在版本还是网络链路。需要注意的是，GitHub 只提供了诊断信号，修复仍需管理员自行推动客户端升级或排查代理；两个计数不可相加、不可跨天累加的限制，也意味着它更适合逐日排查而非直接得出总体覆盖率。