AI小生意项目库 · 阅读档案

2026-11-06 1 浏览免费阅读

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

Q: 这篇文章和哪些AI专题相关？

它适合放在AI副业专题里阅读。 关联原因：这篇内容命中「项目、小生意、变现」等主题信号。

GitHub Copilot 用量指标 API 新增逐用户字段，可直接看出哪些用户没有上报客户端遥测、哪些用户的 IDE 或扩展版本低于用量指标的最低要求，并在企业与组织报告中给出每日受影响人数，便于定位和补齐数据缺口。

AI小生意项目库约 4 分钟读完免费阅读原文 2026-11-06 08:08:31

原贴

查看原文

作者：Allison 来源站点：github.blog 原贴时间： 2026-11-06 08:08:31

原文

The Copilot usage metrics API now shows which users are missing client telemetry or are running IDE or extension versions below the usage metrics minimums. New per-user fields appear in enterprise and organization user reports, and daily affected-user counts appear in enterprise and organization reports. client_telemetry_present : Whether client telemetry was received for the user that day. false means Copilot saw the user’s activity, but no usage events arrived from their editor. usage_metrics_requirements : Lists each of the user’s IDEs and Copilot extensions as met , unmet , or unknown against the minimum supported versions . missing_client_telemetry_user_count : The number of users that day with client_telemetry_present set to false . below_usage_metrics_minimum_user_count : The number of users that day with at least one IDE or extension below the minimum version. Users without client telemetry still count as active, but their reports lack detail such as lines of code, feature breakdowns, and model breakdowns. Common causes include outdated editors or extensions, disabled IDE telemetry, and proxies or firewalls that block events. These fields show how many users are affected and who to follow up with. This way you can close gaps without opening a support ticket. Scope: User fields appear in enterprise and organization user reports (1-day and 28-day). Counts appear in enterprise and organization 1-day reports and in each day_totals entry of 28-day reports. Access: These fields are available to enterprise owners, enterprise billing managers, organization owners, and anyone with a custom organization or enterprise role that grants the View Copilot Metrics permission. The Copilot usage metrics policy must be enabled. Daily counts: Each count covers a single day. A user can be counted in both missing_client_telemetry_user_count and below_usage_metrics_minimum_user_count , so don’t add the two counts together. Don’t add counts across days to count unique users. Independent signals: A user can meet every version minimum and still be missing telemetry (e.g., they’re behind a proxy). Unavailable values: Null or omitted values mean the data is unavailable, not false or zero. Days before this release have no values. Visit the Copilot usage metrics API documentation to get started.

中文翻译

Copilot 用量指标 API 现在可以显示哪些用户缺少客户端遥测，或者正在运行低于用量指标最低版本要求的 IDE 或扩展。企业级和组织级用户报告中新增了逐用户字段，企业级和组织级报告中新增了每日受影响用户数。

client_telemetry_present：当天是否收到了该用户的客户端遥测。false 表示 Copilot 看到了该用户的活动，但没有从他们的编辑器收到任何用量事件。

usage_metrics_requirements：列出该用户的每个 IDE 和 Copilot 扩展相对于最低支持版本的状态，为 met、unmet 或 unknown。

missing_client_telemetry_user_count：当天 client_telemetry_present 被设为 false 的用户数。

below_usage_metrics_minimum_user_count：当天至少有一个 IDE 或扩展低于最低版本的用户数。

没有客户端遥测的用户仍然算作活跃，但他们的报告缺少代码行数、功能细分和模型细分等细节。常见原因包括编辑器或扩展过旧、IDE 遥测被禁用，以及代理或防火墙拦截事件。这些字段显示有多少用户受影响以及该跟进谁。这样你无需提交支持工单就能补齐缺口。

范围：用户字段出现在企业级和组织级用户报告（1 天和 28 天）中。计数出现在企业级和组织级 1 天报告中，以及 28 天报告的每个 day_totals 条目中。

访问权限：这些字段对企业所有者、企业账单管理员、组织所有者，以及任何拥有授予 View Copilot Metrics 权限的自定义组织或企业角色的用户可用。Copilot 用量指标策略必须启用。

每日计数：每个计数只覆盖单日。一个用户可能同时被计入 missing_client_telemetry_user_count 和 below_usage_metrics_minimum_user_count，因此不要把两个计数相加。不要跨天相加计数来计算唯一用户。

独立信号：一个用户可能满足所有版本最低要求，但仍然缺少遥测（例如，他们位于代理之后）。

不可用值：Null 或省略的值表示数据不可用，而不是 false 或零。本次发布之前的日期没有值。访问 Copilot 用量指标 API 文档开始使用。

核心信息

GitHub Copilot 用量指标 API 新增逐用户字段，可直接看出哪些用户没有上报客户端遥测、哪些用户的 IDE 或扩展版本低于用量指标的最低要求，并在企业与组织报告中给出每日受影响人数，便于定位和补齐数据缺口。

GitHub Copilot 用量指标 API 新增逐用户字段，可直接看出哪些用户没有上报客户端遥测、哪些用户的 IDE 或扩展版本低于用量指标的最低要求，并在企业与组织报告中给出每日受影响人数，便于定位和补齐数据缺口。
原贴提到：The Copilot usage metrics API now shows which users are missing client t
来源：github.blog

详细解读

这是什么信号

GitHub 把 Copilot 的用量可观测性从“总量统计”推进到了“逐用户可归因”。过去在企业报表里看到活跃人数和明细对不上，只能猜是不是客户端出了问题；现在 API 直接给出两类标记：谁没有上报客户端遥测，谁的 IDE 或扩展版本低于用量指标的最低要求。这是治理颗粒度的变化，不是一次普通的字段更新。

为什么重要

Copilot 的价值证明依赖数据完整性。缺少客户端遥测的用户依然被计为活跃，但他们的报告里没有代码行数、功能拆分和模型拆分。也就是说，管理层看到的“采用率”和“价值产出”在分母上是失真的，而且这种失真过去无法解释。新字段把“数据缺失”从黑箱变成了可排查清单，并且明确告诉你：不需要开支持工单就能自己定位。

对谁有价值

直接受益者是企业所有者、企业账单管理员、组织所有者，以及被授予 View Copilot Metrics 权限的自定义角色；真正天天用它的，是负责 Copilot 推广落地的平台团队和开发者体验（DevEx）团队。对于要向上汇报 Copilot 投入产出的人来说，这两个字段是解释“为什么明细覆盖不全”的第一手证据。

可以怎么行动

第一，把 1 天报告当作巡检、28 天报告当作趋势，先按 below_usage_metrics_minimum_user_count 圈出版本落后的用户，通过集中管控推动 IDE 与扩展升级。第二，对 missing_client_telemetry_user_count 的用户，优先排查代理和防火墙是否拦截事件，再确认是否有人关掉了 IDE 遥测。第三，把这两类人当作两条独立队列处理，不要合并相加、也不要跨天累加去凑“受影响用户数”，否则结论一定是错的。第四，把“允许遥测上报”写进内部推广文档的前置条件，而不是等缺口出现后再补。

风险与限制

这些字段解决的是可见性，不是使用深度：补齐遥测之后，用户的真实使用情况依然可能很浅。工程上还有几处容易踩的坑——单日计数不等于唯一用户，一个用户可以同时命中两个标记，Null 或省略表示数据不可用而非 false 或零，发布之前的历史日期没有值；此外 Copilot 用量指标策略必须处于启用状态，否则字段不可见。把这些边界讲清楚，比多拉几张报表更重要。

信息差价值

这条内容的真正价值，不只是“有人发布了一个新功能”，而是它揭示了 github.blog 背后的产品方向、工作流变化或竞争信号。对 OPC 来说，这种信息可以转化成持续追踪的栏目选题。

如果把《Copilot 用量指标 API 新增字段，标记遥测缺失与版本不达标》放到你的内容系统里，它最大的价值在于帮助读者更快看懂“为什么值得关注”，而不是只看到一条碎片化动态。

参考来源

Allison 原帖

TOPIC HUBS

延伸专题

AI副业 AI副业：小生意、项目机会与可收费交付

这篇内容命中「项目、小生意、变现」等主题信号。

AI SUMMARY

这篇文章回答了什么