本記事はAIを利用して作成した技術解説・実装例です。掲載するコードや手順は一次情報を基に構成していますが、筆者による実機での動作確認は行っていません。環境やバージョンによって動作が異なる場合があります。 、GitHub Copilot usage metricsにおけるVS Code Agentsに関する変更点を安全に把握し、組織やエンタープライズの利用状況を正確に読み解くための要件と仕組みを整理します。実機環境での検証を行う前に、公式の変更履歴から提供されるメトリクスの構造や、API・集計レポートにおける取り扱いの仕様を事前に確認することを目的とします。
1. 目的
本記事の目的は、GitHub Copilot usage metricsの公式発表に基づき、新たに統合されたVS Code Agentsの利用統計データ項目を正しく理解することです。組織やエンタープライズの管理者・請求担当者が、adoption（普及度）やengagement（エンゲージメント）を測るためのメトリクス構造を整理し、利用時の注意点やアクセス権限の前提を明らかにします。
2. 前提・注意点
【Windows環境で確認予定】 または 【実機確認前】：本稿で解説するAPIや集計項目の出力を実環境のPowerShellやCLIで直接取得した結果は示していません。
対象機能の限定：ここでのメトリクスは、専用のVS Code Agentsウィンドウにおけるアクティビティを対象としています。エディターウィンドウ内のAgent Modeや、一般的な汎用利用のロールアップとは別個に管理されます。
権限の管理：エンタープライズオーナー、請求マネージャー、組織オーナー、または「View Copilot Metrics」権限を持つカスタムロールが付与されたユーザーのみがアクセス可能です。また、Copilot usage metricsポリシーが有効化されている必要があります。
データ不在時の挙動：後方互換性が維持されており、VS Code Agentsウィンドウのデータが存在しない場合、オプショナルなフィールドは不在となるか
nullが返されます。
3. 追加されたメトリクスの構成要素
一次情報によると、エンタープライズおよび組織の集計レポート（1日および28日期間）には、専用のVS Code Agentsウィンドウに関する新しいメトリクスが含まれるようになりました。ここでは、追加された主要な要素を個別に確認します。
flowchart TD
A[Copilot Usage Metrics] --> B[Aggregate Reports: 1-day / 28-day]
A --> C[User-Level Reports: Enterprise / Org]
B --> B1[daily_active_vscode_agent_users: 1日あたりのユニークユーザー数]
B --> B2[totals_by_vscode_agent: session_count と total_user_messages の集計]
C --> C1[used_vscode_agent: 利用有無を示すオプショナルな指標]
C --> C2[totals_by_vscode_agent: ユーザーごとのセッション数とメッセージ数]
daily_active_vscode_agent_users
集計レポートにおいて、毎日専用のVS Code Agentsウィンドウでアクティブだったユニークユーザーの数を示すオプショナルなカウント項目です。組織全体での1日あたりの利用規模を把握するために利用されます。
totals_by_vscode_agent (集計レポート)
VS Code Agentsに関する session_count（セッション数）および total_user_messages（総ユーザーメッセージ数）のオプショナルな合算値です。これにより、単なる人数だけでなく、メッセージのやり取りやセッションの頻度を通じたエンゲージメントの深さを測定できます。
used_vscode_agent
エンタープライズユーザーおよび組織ユーザーレベルのレポート（1日および28日期間）に含まれる項目です。個々のユーザーがVS Code Agentsウィンドウを利用したかどうかを示すオプショナルなインジケーターとして機能します。
totals_by_vscode_agent (ユーザーレベル)
ユーザーレベルのレポートにおける、個別ユーザー単位での session_count と total_user_messages の値です。チーム間での利用状況のばらつきや、特定のチームにおける活用度を細かく把握するために役立ちます。
4. APIおよびレポート活用のポイント
公式のCopilot usage metrics APIを活用する際は、次のポイントに留意する必要があります。
レポート期間の選択：1日単位（1-day）および28日単位（28-day）の双方が提供されているため、短期的な動向の変化と中長期的な定着度の双方を追跡できます。
データ分離の理解：VS Code Agentsウィンドウのメトリクスは、エディターウィンドウ内のAgent Modeや従来の汎用集計とは明確に区別されています。そのため、全体の集計値と混同しないよう注意が必要です。
ポリシーとアクセス設定：APIを呼び出す前に、GitHub上でCopilot usage metricsポリシーが正しく有効化されており、実行ユーザーに必要な権限（View Copilot Metricsなど）が割り当てられていることを確認してください。
5. 制限
本記事で扱う内容は、2026年9月11日時点の公式チャングログに基づく仕様解説であり、今後のAPIの更新や機能拡張によってフィールド名や挙動が変更される可能性があります。
実機環境におけるAPIレスポンスの具体的なJSON出力や、PowerShell等を用いたスクリプトによる実測値の記録は行っていないため、導入時には公式のCopilot usage metrics APIドキュメントを直接参照してください。
6. まとめ
実行前に確認すべき点:
組織またはエンタープライズでCopilot usage metricsポリシーが有効になっているか。
アクセスを行うユーザーに「View Copilot Metrics」権限または適切なオーナー権限が付与されているか。
取得するデータが通常のEditor Agent Modeではなく、専用のVS Code Agentsウィンドウを対象としているか。
制約:
本記事の内容は実機未検証の調査に基づくものであり、環境やAPIバージョンの違いによって動作が異なる場合があります。
オプショナルなフィールドの欠損や
null値の挙動は、後方互換性に基づきデータ不在時に発生するため、アプリケーション側のパース処理で考慮する必要があります。
