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