用量与采用指标
选择用量、影响和代码生成看板，并区分行为统计、席位与计费。
Copilot usage metrics 用于观察采用、交互、代码生成与 PR 流程趋势。它们覆盖企业、组织和用户等范围，但不同报表的对象、时间窗口与字段不相同。
按分析问题选择章节
| 问题 | 文档 |
|---|---|
| 哪些活动被收集，缺失数据怎么查 | 采集范围与版本 |
| 从哪里查看趋势 | 三类看板 |
| 用户为什么属于某个采用阶段 | 采用分组与影响 |
| 如何读取 API / NDJSON | 字段与报表结构 |
| 建议、接受和代码行数分别是什么 | LoC 指标 |
| CLI、app、Agents window 如何区分 | 客户端独立指标 |
| Skills、MCP、插件使用如何解释 | CLI 定制指标 |
| 如何按团队汇总 | 按日关联团队 |
| PR 创建、评审与合并如何统计 | PR 生命周期 |
| 多个报表为什么数字不同 | 核对统计口径 |
与许可证、费用分开
Usage metrics 不提供席位授权清单；许可证事实以 Copilot user management API 为准。用户报表中的 ai_credits_used 用于消耗分析，也不是发票总额。费用、共享池与预算见计费与预算。
新分析应采用当前 usage metrics 数据模型，不把不同 API 的计数直接作差，或把旧的单一行内补全统计与现在包含多种功能的事件数当成连续同口径数据。
解释趋势
活跃用户、采用分组、接受率、代码行数与 PR 流程各回答不同问题。应组合观察，并结合团队反馈、任务类型和配置状态；单一数值不足以证明代码质量或个人生产力。
席位活动报告
本节文档
- 采集范围、成员归属与版本检查客户端遥测、服务端补充、组织重复归属和数据更新时间。
- 查看用量、影响与代码生成看板选择 Insights 下的入口，按图表实际时间窗口和数据范围解读。
- 采用阶段、人数分母与影响比较按滚动窗口理解 Phase 1–3，并区分每日活跃人数和完整阶段人群。
- API 报表结构与基础字段区分用户、聚合、28 天封装和仓库记录，正确处理事件数与可选字段。
- 代码行数与 Agent 编辑区分建议、接受、直接编辑以及各 IDE 的 LoC 采集版本。
- CLI、App 与 Agents window 指标按客户端读取会话、请求、提示和 token，并区分独立窗口与 IDE agent mode。
- CLI Skills、MCP 与插件采用解读前五名、隐藏标识、连接事件和不同标识去重。
- 构建团队用量报表按同一天的用户用量与团队关系关联，处理五席门槛和重复成员。
- PR 生命周期与评审耗时区分每日事件、Copilot 子集和仅符合条件的人类评审阶段。
- 核对看板、API 与导出差异先对齐人群、窗口、遥测覆盖和导出时间，再检查异常。
- 下载席位活动 CSV查看认证、最近活动和入口信息，区分活动报告与采用指标导出。
- 解释 last_activity_at识别活动事件、24 小时处理延迟和90天后 nil 的含义。