API を通じてチームレベルの Copilot 利用状況メトリクスが公開されました
GitHub が Copilot の利用状況分析機能を強化し、API を通じて組織レベルからチーム単位での詳細な使用メトリクス取得を可能にした。
キーポイント
チーム別メトリクスの API 公開
エンタープライズ管理者や組織オーナーが、Copilot ライセンスを持つユーザーを所属チームにマッピングし、チーム単位でのアクティブユーザー数や完了数などを取得できるようになった。
詳細な分析機能の提供
言語、IDE、機能タイプ、モデル別などの breakdown が可能になり、チームごとの採用度やコード生成活動を細かく切り分けて分析できる。
実装ガイドと制限事項
ユーザー-チームレポートと個人利用レポートを結合する手順がドキュメントで提供されたほか、5 名未満のチームは除外されるなどの制限が明記されている。
影響分析・編集コメントを表示
影響分析
この機能により、大規模組織は Copilot の導入効果を定量的かつ構造的に評価できるようになり、特定のチームへのリソース配分や教育プログラムの最適化が容易になります。しかし、ダッシュボード機能がなく API 経由のみであることや、小規模チームの除外ルールがある点は、即座の可視性には課題を残します。
編集コメント
Copilot の導入効果を組織内で公平かつ詳細に評価するための重要なツールが整いました。ただし、API 経由でのデータ取得が必要となるため、既存の分析基盤との連携検討が求められるでしょう。
Copilot 使用状況メトリクス API に、各 Copilot ライセンス保有ユーザーを所属チームにマッピングする新しいユーザー・チームレポートが追加されました。このユーザー・チームレポートと既存のユーザー別使用状況レポートを結合することで、企業管理者や組織オーナーは、自らの組織または企業内の任意のチームに対するチームレベルの Copilot 使用状況メトリクス（アクティブユーザー数、完了数、チャット数など）を生成できるようになります。また、言語、IDE、機能、モデルごとの内訳も含まれます。
仕組み
2 つの新規エンドポイントが、NDJSON レポートへの署名付きダウンロード URL を返します:
GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day
GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day
ユーザー・チームレポートの各行は、特定の日のチーム所属を表しており、そのチームの企業 ID または組織 ID、チームスラッグ、およびユーザー ID とログイン名が含まれます。チームレベルのメトリクスを生成するには、user_id と day をキーとしてユーザー・チームレポートをユーザー別使用状況レポートに結合し、集計を行います。
今回のリリースでは、ドキュメントにおいて、結合処理、日次集計、および多日レポート用のローリングウィンドウパターンに関するステップバイステップのガイダンスも新たに追加されました。
この機能の利用対象者
これらのメトリクスは、REST API を通じて、企業管理者、組織オーナー、請求管理担当者、および「View Enterprise Copilot Metrics」権限を持つ企業カスタムロールのユーザーが利用できます。
主な利点
チーム別スライス指標：組織または企業全体の合計から、外部のチーム帰属情報を構築することなく、任意の組織または企業のチーム単位まで Copilot の採用状況、アクティブユーザー数、コード生成活動をピボット表示できます。
チャンピオンとギャップの特定：どのチームが採用を推進しているか、どのチームに支援が必要かを把握し、キャンペーンや展開投資をターゲット化できるようにします。
機能カバレッジの完全性：IDE 補完、チャット、Copilot CLI、コードレビュー、Copilot クラウドエージェント活動に関するチーム別内訳が利用可能です。言語、IDE、機能、モデルごとに切り分けが可能です。
重要な注意事項
ユーザー・チームレポートは REST API を通じてのみ利用可能です。今回のリリースでは、チームレベルの指標に対するダッシュボード画面は用意されていません。
Copilot のライセンスを保有するユーザーが 5 名未満のチームは、ユーザー・チームレポートから除外されますが、そのメンバー個々の活動は、ユーザー別使用状況レポートでは引き続き確認できます。
複数のチームに所属しているユーザーの場合、その活動は各チームの集計値に含まれるため、チームごとの合計を単純に加算しても組織全体または企業全体の合計を再現することはできません。
結合レシピやローリングウィンドウ集計を含むステップバイステップガイドについては、「Team-level Copilot usage metrics」をご覧ください。
GitHub Community 内のディスカッションに参加してください。
「Team-level Copilot usage metrics now available via API」という投稿は、The GitHub Blog で最初に公開されました。
原文を表示
The Copilot usage metrics API now exposes a new user-teams report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing per-user usage report, enterprise administrators and organization owners can produce team-level Copilot usage metrics for any team in their organization or enterprise. This includes elements such as active users, completions, chats, as well as breakdowns by language, IDE, feature, and model.
How it works
Two new endpoints return signed download URLs to NDJSON reports:
GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day
GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day
Each row in the user-teams report represents a team membership for a given day, including the team’s enterprise or organization id, team slug, and the user’s ID and login. To produce team-level metrics, join the user-teams report to the per-user usage report on user_id and day, then aggregate.
This release also introduces step-by-step guidance in the docs covering the join, day-level aggregation, and a rolling-window pattern for multi-day reporting.
Who can use this feature
These metrics are available through the REST API to enterprise administrators, organization owners, billing managers, and people with an enterprise custom role with the View Enterprise Copilot Metrics permission.
Key benefits
Slice metrics by team: Pivot Copilot adoption, active users, and code generation activity from org/enterprise totals down to any organization or enterprise team without building external team attribution.
Identify champions and gaps: See which teams are driving adoption and which need enablement, so you can target campaigns and rollout investments.
Full feature coverage: Team-level breakdowns are available across IDE completions, chat, Copilot CLI, code review, and Copilot cloud agent activity. They can be cut by language, IDE, feature, or model.
Important notes
User-teams reports are available through the REST API only. There is no dashboard surface for team-level metrics in this release.
Teams with fewer than five Copilot-seated users are excluded from the user-teams report, though their members’ individual activity remains visible in the per-user usage report.
Users who belong to multiple teams will have their activity counted in each team’s aggregate, so team totals cannot be summed to reproduce an organization or enterprise total.
For step-by-step guidance, including the join recipe and rolling-window aggregation, see Team-level Copilot usage metrics.
Join the discussion within GitHub Community.
The post Team-level Copilot usage metrics now available via API appeared first on The GitHub Blog.
関連記事
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み