{"meta":{"title":"GitHub Copilot的指标数据属性","intro":"了解GitHub如何从 API 和报表计算属性。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/zh/enterprise-cloud@latest/copilot/reference","title":"参考资料"},{"href":"/zh/enterprise-cloud@latest/copilot/reference/metrics-data","title":"指标数据"}],"documentType":"article"},"body":"# GitHub Copilot的指标数据属性\n\n了解GitHub如何从 API 和报表计算属性。\n\n## `last_activity_at`\n\n> \\[!NOTE] 此数据位于公共预览版，且可能会更改。\n\n用户最近与 Copilot 功能的交互的时间戳。\n\n### 图面\n\n此属性在以下位置保持一致：\n\n* 从“访问管理”页下载的 CSV 报告（请参阅 [查看组织中GitHub Copilot 的用户活动数据](/zh/enterprise-cloud@latest/copilot/how-tos/administer/organizations/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization)）\n* [用于Copilot用户管理的 REST API 终结点](/zh/enterprise-cloud@latest/rest/copilot/copilot-user-management)\n\n### 计算\n\n以下交互计为活动：\n\n* 在 IDE 中接收代码建议\n* 在 副驾驶聊天 IDE 中聊天\n* 生成拉取请求摘要\n* 在 GitHub 中与 副驾驶聊天 交互\n* 在移动设备上与Copilot交互\n* 使用 副驾驶聊天 进行 CLI 交互\n\n跟踪的事件来自客户端和服务器端的遥测，可确保在网络条件影响客户端遥测时，时间戳是持久的。\n\n处理新的遥测事件和更新用户的 `last_activity_at` 日期可能最多需要 24 小时。 用户必须在其 IDE 中启用遥测，才能在 `last_activity_at` 中反映其使用情况。\n\n### 保留期\n\n* `last_activity_at` 数据的保留期为 90 天。 此值不能修改。\n* 在 90 天后没有新活动后，用户的 `last_activity_at` 值将设置为 `nil`。\n\n有关详细信息，请参阅 [将 Copilot 用户管理 API 中的 `last_activity_at` 值的保留周期更新为 90 天](https://github.blog/changelog/2025-01-17-updating-retention-period-for-last_activity_at-values-on-the-user-management-api-public-preview-to-90-days/)，请见 the GitHub Blog。\n\n## Copilot活动报告\n\nCopilot活动报告显示组织或企业的用户活动数据。\n\n报告中的数据每 30 分钟会自动刷新一次。\n\n### 字段\n\n| 字段                      | 说明                          |\n| ----------------------- | --------------------------- |\n| `report_time`           | 报告生成时的 UTC 时间戳              |\n| `login`                 | GitHub Copilot用户的用户名        |\n| `last_authenticated_at` | 用户最新身份验证的 UTC 时间戳           |\n| `last_activity_at`      | 用户最近Copilot交互的 UTC 时间戳      |\n| `last_surface_used`     | 最近使用的Copilot功能：<br><ul><li> |\n\n```\n          **IDE**：编辑器名称和版本（例如“VS Code 1.89.1”）</li><li>\n          **GitHub.com**：功能名称（例如“Copilot 对话助手”）</li><li>\n          **未指定**：当 IDE 详细信息不可用或不存在近期活动时</ul> |\n```\n\n### 保留期\n\n活动和身份验证数据会保留 90 天的滚动周期，这与 `last_activity_at` 字段的设置一致。\n\n### 包含的功能\n\n活动报告提供对 IDE、GitHub、GitHub CLI 以及 GitHub Mobile 中所有正式版 GitHub Copilot 功能使用情况的概览。\n\n#### IDE 功能\n\n* 内联建议\n* 下一个编辑建议\n* 副驾驶聊天\n* 代理模式\n* Copilot Edits 在 VS Code 中\n\n#### GitHub功能\n\n* 副驾驶聊天\n* Copilot云代理\n* Copilot for Docs\n* Copilot拉取请求摘要\n* Copilot 代码评审\n\n### 限制\n\n可能 GitHub 缺乏来自 VS Code 以外部分第三方 IDE（如 JetBrains 和 Xcode）的一致遥测数据。 用户应确保运行的是 IDE 的最新版本。\n\n活动报告可能排除尚未正式发布 (GA) 的 GitHub Copilot 功能的使用情况。 目前，以下功能未完全记录：\n\n* Copilot空间\n* Copilot Spark"}