Usage metrics API adds usage from tools like OpenCode
By Steven Van ·
Enterprise and organization admins get per-client request, session and token counts, including OpenCode, Claude Code and Codex, in 1-day and 28-day reports.
The GitHub Copilot usage metrics API now counts model usage from tools such as OpenCode, which were not previously captured in Copilot reports. The change adds a totals_by_client array to the existing reports.
What each entry contains
Each totals_by_client entry represents one client and includes:
- client: the tool that sent the requests, such as opencode, claude_code, codex, zed, copilot_cli, github_app, cloud_agent, code_review, vscode, or jetbrains. Unrecognized clients are grouped under other.
- request_count: the number of successful model requests from the client.
- session_count: the number of distinct sessions from the client.
- token_usage: prompt tokens, output tokens, and average tokens per request.
- totals_by_model: the same request and token metrics broken down by model.
Within totals_by_model, a model_selection_mode shows whether the model was requested directly (user_selected), chosen by auto (auto), or chosen by the product (product_selected). Selection modes not yet reported individually appear as other, and values that can't be normalized appear as unknown.
Why the gap existed
More developers use Copilot as the model provider behind tools outside the IDE. Those tools often don't send editor telemetry, so their usage was missing from totals_by_ide. Requests are now counted on the server, which lets admins compare request and token volume across tools.
GitHub notes this differs from agent app activity, which counts jobs started by agent apps such as Claude and Codex on GitHub. totals_by_client measures model traffic, meaning requests and tokens, from any tool that uses Copilot.
Scope and access
totals_by_client is available in the enterprise, organization, enterprise-user, and organization-user reports, in both 1-day and 28-day versions. In the aggregated 28-day reports it appears in each day_totals entry.
Access is open to enterprise owners and billing managers, organization owners, and anyone with a custom organization or enterprise role that grants the View Copilot Metrics permission. The Copilot usage metrics policy must be enabled.
