Skip to main content
Skip to content

Coverage and requirements for Copilot usage metrics

Check which activity Copilot usage metrics include and which IDE versions are required for detailed reporting.

Quem pode usar esse recurso?

Proprietários corporativos, gerentes de cobrança corporativos, proprietários de organizações e pessoas com uma função corporativa ou de organização personalizada com a permissão "Exibir Métricas da Organização Copilot " ou "Exibir Métricas da Empresa Copilot ".

Copilot usage metrics combine client-side and server-side telemetry. Coverage varies by surface and report.

Included activity

Usage metrics include IDE, Copilot CLI, and agent apps activity.

Metrics broken down by agent app are available in the usage metrics APIs and NDJSON exports, but not in the usage metrics dashboards. Activity from agent apps is already included in daily, weekly, and monthly active-user totals through server-side telemetry. These breakdowns do not change the active-user totals.

Detailed IDE breakdowns depend on client-side telemetry. Server-side telemetry can identify active users that client-side telemetry misses, but can't provide all the same breakdowns. For missing-data troubleshooting and an explanation of how these sources affect totals, see Reconciliando métricas de uso do Copilot entre dashboards, APIs e relatórios.

IDE and client coverage

IDE-based metrics describe activity in supported editors, not Copilot Chat on GitHub.com or GitHub Mobile activity.

However, the usage metrics APIs and exports also provide server-side client metrics in totals_by_client. These metrics count successful model requests through the Copilot API. Known client values include github_web and github_mobile, so these surfaces aren't excluded from all usage metrics reports. Client request counts aren't equivalent to IDE activity or prompt counts. See Dados disponíveis nas métricas de uso do Copilot.

License and seat data

License and seat management data aren't included in usage metrics reports. To view or manage license assignments, use the Copilot user management API, which is the source of truth for license and seat information. See Endpoints da API REST para gerenciamento de usuários do Copilot.

Supported IDEs

For detailed IDE-based usage metrics, end users must enable IDE telemetry and use the following minimum IDE and Copilot Chat extension versions.

Older versions may not send all the events that usage metrics rely on, or may attribute activity to the wrong IDE. Keep IDEs and Copilot extensions current, and use device management tooling to enforce these minimum versions where possible.

IDEMinimum IDE versionMinimum Copilot Chat extension version
Eclipse4.310.9.3.202507240902
JetBrains / IntelliJ2024.2.61.5.52-241
Visual Studio17.14.1318.0.471.29466
VS Code1.107.10.35.3
Xcode14.3.10.40.0

In per-user reports, each totals_by_ide entry includes last_known_ide_version and last_known_plugin_version. Use these fields to identify developers who need to update.

Version requirements for SDK-based agent activity

Some IDEs run Copilot agent sessions through the Copilot SDK. Some versions of these IDEs don't identify themselves when they send agent activity, so that activity is left out of usage metrics. This causes agent interactions and agent lines of code to be undercounted. To include this activity, end users must use one of the following versions or later:

IDEMinimum version for SDK-based agent activityAffected versions
VS Code1.139.01.134 through 1.138, when using the agent window
Copilot plugin for JetBrains IDEs1.20.01.15.0 through 1.19.x
Visual Studio18.12Insiders (preview) builds before 18.12

If you're planning IDE updates, move developers directly to these versions or later. Generally available versions of Visual Studio aren't affected.

For JetBrains IDEs, avoid Copilot plugin versions 1.15.0 through 1.19.x.

Eclipse and Xcode don't run agent sessions through the Copilot SDK, so they aren't affected.

Missing data can't be backfilled, because activity from affected versions doesn't identify which IDE it came from.

Some of this activity was counted as Copilot CLI activity instead, which can inflate Copilot CLI metrics. This clears up as developers update the affected IDEs, but earlier Copilot CLI metrics can't be corrected. Copilot CLI users don't need to update.

This issue affects only how activity is attributed in usage metrics. Billing is not affected.