98 lines
4.3 KiB
Markdown
98 lines
4.3 KiB
Markdown
---
|
|
title: Metrics data properties for GitHub Copilot
|
|
shortTitle: Metrics data
|
|
intro: See how GitHub calculates properties from APIs and reports.
|
|
versions:
|
|
feature: copilot
|
|
category:
|
|
- Learn about Copilot
|
|
topics:
|
|
- Copilot
|
|
allowTitleToDifferFromFilename: true
|
|
contentType: reference
|
|
---
|
|
|
|
## `last_activity_at`
|
|
|
|
> [!NOTE] This data is in {% data variables.release-phases.public_preview %} and subject to change.
|
|
|
|
The timestamp of a user's most recent interaction with {% data variables.product.prodname_copilot_short %} functionality.
|
|
|
|
### Surfaces
|
|
|
|
This property is consistent across the following surfaces:
|
|
|
|
* The CSV report downloaded from the "Access management" page (see [AUTOTITLE](/copilot/how-tos/administer/organizations/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization))
|
|
* The [AUTOTITLE](/rest/copilot/copilot-user-management)
|
|
|
|
### Calculation
|
|
|
|
The following interactions count as activity:
|
|
|
|
* Receiving a code suggestion in an IDE
|
|
* Chatting with {% data variables.copilot.copilot_chat_short %} in an IDE
|
|
* Generating a pull request summary
|
|
* Interacting with {% data variables.copilot.copilot_chat_short %} in GitHub
|
|
* Interacting with Copilot on a mobile device
|
|
* Interacting with {% data variables.copilot.copilot_chat_short %} for CLI
|
|
|
|
The tracked events come from both client- and server-side telemetry, ensuring the timestamp is durable if network conditions affect client-side telemetry.
|
|
|
|
Processing new telemetry events and updating a user's `last_activity_at` date can take up to 24 hours. Users must have telemetry enabled in their IDE for their usage to be reflected in `last_activity_at`.
|
|
|
|
### Retention period
|
|
|
|
* The retention period for `last_activity_at` data is 90 days. This cannot be modified.
|
|
* After 90 days of no new activity, a user's `last_activity_at` value is set to `nil`.
|
|
|
|
For more information, see [Updating retention period for `last_activity_at` values on the Copilot user management API to 90 days](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/) on {% data variables.product.prodname_blog %}.
|
|
|
|
## Copilot activity report
|
|
|
|
The Copilot activity report shows user activity data for an organization or enterprise.
|
|
|
|
Data in the report refreshes automatically every 30 minutes.
|
|
|
|
### Fields
|
|
|
|
| Field | Description |
|
|
|-------|-------------|
|
|
| `report_time` | UTC timestamp when the report was generated |
|
|
| `login` | GitHub username of the Copilot user |
|
|
| `last_authenticated_at` | UTC timestamp of the user's most recent authentication |
|
|
| `last_activity_at` | UTC timestamp of the user's most recent Copilot interaction |
|
|
| `last_surface_used` | The Copilot feature used most recently:<br><ul><li>**IDE**: Editor name and version (e.g. "VS Code 1.89.1")</li><li>**GitHub.com**: Feature name (e.g., "Copilot Chat")</li><li>**Unspecified**: When IDE details are unavailable or no recent activity exists</ul> |
|
|
|
|
### Retention period
|
|
|
|
Activity and authentication data are retained for a rolling 90-day period, consistent with the `last_activity_at` field.
|
|
|
|
### Included features
|
|
|
|
The activity report provides visibility into usage of all generally available (GA) GitHub Copilot features in the IDE, on GitHub, in GitHub CLI, and on GitHub Mobile.
|
|
|
|
#### IDE features
|
|
|
|
* Inline suggestions
|
|
* {% data variables.copilot.next_edit_suggestions_caps %}
|
|
* {% data variables.copilot.copilot_chat_short %}
|
|
* Agent mode
|
|
* {% data variables.copilot.copilot_edits_short %} in VS Code
|
|
|
|
#### GitHub features
|
|
|
|
* {% data variables.copilot.copilot_chat_short %}
|
|
* {% data variables.copilot.copilot_coding_agent %}
|
|
* Copilot for Docs
|
|
* {% data variables.copilot.copilot_for_prs %}
|
|
* {% data variables.copilot.copilot_code-review_short %}
|
|
|
|
### Limitations
|
|
|
|
There is a possibility that {% data variables.product.github %} lacks consistent telemetry from some third party IDEs outside of VS Code (such as JetBrains and Xcode). Users should ensure they're running the latest version of their IDE.
|
|
|
|
The activity report may exclude usage of {% data variables.product.prodname_copilot %} features that are not yet generally available (GA). Currently, the following features are not fully recorded:
|
|
|
|
* {% data variables.copilot.copilot_spaces %}
|
|
* Copilot Spark
|