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

一句话看懂：GitHub Copilot 用量指标 API 新增按用户字段和每日计数，直接标出哪些用户缺少客户端遥测、哪些 IDE 或扩展版本低于用量统计最低要求，帮助企业定位报告数据缺口。

事件核心：发生了什么

2026 年 11 月 5 日，GitHub 在 Changelog 中宣布 Copilot 用量指标 API 更新。企业级和组织级用户报告中新增三个按用户字段：client_telemetry_present 表示当天是否收到该用户的客户端遥测；usage_metrics_requirements 列出该用户每个 IDE 和 Copilot 扩展相对最低支持版本的状态，分为满足、不满足或未知；组织与企业报告中还新增两个每日计数，分别统计遥测缺失用户数和版本低于最低要求的用户数。按用户字段覆盖 1 天和 28 天报告，计数则出现在 1 天报告以及 28 天报告的每日汇总中。上述字段面向企业所有者、企业计费管理员、组织所有者，以及拥有“查看 Copilot 指标”权限的自定义角色，且需启用 Copilot 用量指标策略。

为什么重要

缺少客户端遥测的用户仍会被计为活跃，但其报告会缺失代码行数、功能使用和模型分布等细节。常见原因包括编辑器或扩展版本过旧、IDE 遥测被关闭，以及代理或防火墙拦截事件。过去，这类数据缺口往往需要提交支持工单才能排查；新字段把问题直接暴露在指标 API 中，让管理员先看到影响范围，再针对具体用户跟进。对企业而言，这意味着 Copilot 的采用率统计和投资回报评估可以建立在更完整的数据上，减少因遥测缺失造成的误判。

对用户/开发者/创作者的影响

对使用 Copilot 的开发者，这些字段不直接改变日常使用，但可能带来内部提醒：升级 IDE 或扩展版本、检查遥测设置，或确认企业网络是否拦截上报。对企业管理员和平台团队，新字段提供了自动化的排查入口，可用于识别需要升级或网络调整的用户群体。开发者若通过 API 构建内部报表，也需要注意两个独立信号：版本达标不代表遥测正常，代理环境仍可能丢数据；同一用户可能同时出现在两个计数中，不同日期的计数也不应直接相加去重。