Michael Johnson開発者がサードパーティ製ツールを通じてCopilotを利用すると、通常のIDE別統計ではリクエストの発生元が分からないことがあります。2026年10月23日、GitHubはCopilot usage metrics APIにtotals_by_clientフィールドを追加しました。このフィールドは、OpenCode、Claude Code、Codex、Zedなどのクライアント別にモデルの利用状況を集計します。管理者は、エディター外での利用状況の一部を把握し、社内のAI利用ルールについて、より具体的に検討できるようになります。
新しい内訳で分かること
totals_by_clientの各項目には、クライアント名、成功したモデル呼び出しの数、セッション数、promptトークンとoutputトークンの合計、および呼び出しあたりの平均トークン数が含まれます。ネストされたtotals_by_modelでは、これらの指標をモデル別に分け、選択モードも示します。選択モードは、ユーザーがモデルを直接選択した場合、自動選択が行われた場合、または製品がモデルを割り当てた場合を表します。
このフィールドは、企業、組織、およびそれらのユーザー別内訳を含む1日単位と28日単位のレポートに追加されました。集計済みの28日レポートでは、各日についてクライアント別の詳細を確認できます。今回の変更は後方互換性のある追加で、従来のフィールドは維持され、データがない場合は配列が空のままになります。詳細は、GitHubのusage metricsの新しい内訳に関する発表をご覧ください。
データから分かること
チームは、異なるツール経由で発生したリクエスト数やトークン数を比較し、どの連携機能をサポートするか、または社内ルールの対象にするかを判断できます。たとえば、レポート内でOpenCodeの割合が増えていれば、開発者がIDE外でCopilotをモデル提供元として利用している可能性が示されます。クライアントとモデルを照合すれば、実際にどのモデルが主な負荷を生み出しているかも確認できます。
予算分析では、まずトークン数と呼び出し数を確認し、適用中の料金条件と照らし合わせるとよいでしょう。request_countが数えるのはモデル呼び出しであり、ユーザーのプロンプト数ではありません。1つのプロンプトから複数の呼び出しが発生する場合があります。そのため、このフィールドはモデルサービスの負荷分析には適していますが、開発者とのやり取りの回数を直接数える用途には適しません。
業務プロセスへの取り入れ方
- アクセス権を確認する。 Copilot usage metricsポリシーを有効にする必要があります。レポートを取得できるのは、権限を付与された企業または組織のオーナー、請求管理者、および該当するメトリクスの閲覧権限を持つロールです。
- 同じ期間どうしを比較する。 ツールを有効にした後の変化を確認するには1日単位のレポートを、継続的な利用状況を把握するには28日単位のレポートを使います。レポート内では呼び出し数、トークン数、セッション数を分けて扱ってください。これらは負荷を測る異なる指標です。
- 調査のしきい値を設定する。 たとえば、クライアント別のトークンまたは呼び出しの割合が、直前の期間と比べて大きく増えた場合にフラグを立てます。しきい値は、自社の要件と通常時の負荷に応じて設定してください。GitHubは共通のしきい値を定めていません。
- レポートをアクセス設定と照合する。 新しい内訳は、ツールのサポートや管理について検討する際の判断材料として利用できます。ただし、レポートが示すのは記録された利用状況であり、権限の確認や連携機能の棚卸しに代わるものではありません。
公式のCopilot usage metrics APIドキュメントでは、レポート、権限要件、利用可能な内訳が説明されています。自動化する前に、必要なレポートの最新のスキーマを確認し、適切なアクセス権限を使用してください。
クライアントラベルの意味
GitHubは、ツールがリクエストとともに送信するintegration IDを使ってクライアントを識別します。同社はこのグループ分けを概算の識別情報として明示しています。値はトラフィックの集計には役立ちますが、それだけでユーザーの本人確認やアプリの真正性を証明するものではありません。不明なクライアントはotherに分類され、正規化できない値はunknownと表示されることがあります。
個別の例外もあります。Copilot code reviewとCopilot cloud agentの呼び出しでは、モデルを製品が選択するため、選択モードはproduct_selectedになります。code reviewでは、モデルがunknownと表示されることがあります。ツール間でモデル別の内訳を比較する際には、この点を考慮してください。
要するに、totals_by_clientによって、外部ツールからのCopilotのサーバー側呼び出しを把握する際の空白が埋まり、管理者は負荷の分析やサポート方針の判断に役立つ新しいデータを得られます。この内訳を信頼できる利用状況の全体像につなげるには、アクセス権や他の社内情報源と照合し、クライアント名は証明済みの識別情報ではなく、トラフィックの分類として扱ってください。