一言で
Copilot Metrics は、製品テレメトリと Pull Request の活動を導入状況と開発効果のストーリーに変える。
意思決定にはダッシュボード、自動化、独自 BI、履歴管理には API を使う。
🎯 アクティブユーザー数だけで判断しない。導入、活用、コード生成、Pull Request の流れを組み合わせて見る。
何を測る?
| シグナル | 例 | 分かること |
|---|---|---|
| 👥 導入 | DAU、WAU、導入フェーズ | 誰がどの深さで使っているか |
| 💬 活用 | Chat リクエスト、モード、Agent | どのワークフローが定着しているか |
| ✅ 受け入れ | 提案数、採用数、採用率 | 出力が有用で信頼されているか |
| 🧱 コード生成 | 提案、追加、削除された行数 | どれだけ AI が編集を支援したか |
| 🔀 開発フロー | PR 作成、マージ、中央値のマージ時間 | 導入とスループットの関係 |
UI と API のデータ期間
| 画面または API | 参照できる期間 | 主な用途 |
|---|---|---|
| Usage metrics dashboard | 過去 28 日 の推移 | 日々の導入と機能利用の確認 |
| Impact dashboard | 6 か月 の Cohort と PR 推移 | 経営向け説明と Enablement |
| 日次 API report | 2025 年 10 月 10 日以降、最大 1 年 | BI 連携と期間比較 |
| 最新 28 日 API report | 直近 28 日 | Enterprise または User の概要 |
| NDJSON export | 自社ストレージで保持 | GitHub の期間を超える独自分析 |
API の要点
新しい連携には Copilot usage metrics API を使う。Enterprise、Organization、User、Repository、Team 結合用の report を期限付き署名 URL で取得できる。
GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-1-day?day=YYYY-MM-DD
GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD
GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD
GET /orgs/{org}/copilot/metrics/reports/organization-1-day?day=YYYY-MM-DD- Enterprise: Owner、Billing Manager、または View Enterprise Copilot Metrics 権限
- Token scope:
read:enterpriseまたはmanage_billing:copilot - Organization: Owner または View Organization Copilot Metrics 権限と
read:org
⚠️ 署名付き URL は期限内にダウンロードする。Seat と License の正本には Metrics ではなく User management API を使う。
★ Copilot Impact Dashboard
Enterprise 管理者と Organization Owner が、4 つの問いに答えるための Dashboard。
| Dashboard セクション | ひと目で分かること |
|---|---|
| 👥 Adoption cohorts | Passive、Code-first、Agent-first、Multi-agent の分布。人数、割合、PR/User/Month、マージ速度、LoC/Day を表示。 |
| ✖️ Adoption multiplier | Engaged User の平均スループットと速度が Passive Cohort と比べてどう違うか。 |
| 📈 Trends | Cohort の成長と Pull Request throughput が過去 6 か月でどう変化したか。 |
| 🎯 Recommended next steps | より深い導入フェーズへ進めるために、次に実行すべき具体的な Enablement。 |
🎯 「誰が Active か」だけでなく、どこまで深く導入されたかと次にどこを支援すべきかを説明する。
数字を正しく読む
収集方法と集計範囲を理解すると、メトリクスをより正確に解釈できる。
- データは通常、対象日の終了から UTC で丸 2 日以内 に利用できる
- IDE telemetry が機能別と LoC の詳細を提供し、server-side signal が Active User の集計を補完する
- GitHub.com の Copilot Chat と GitHub Mobile の利用は含まれない
- Organization report は所属に基づくため同じ User が複数 Organization に現れ、Enterprise 合計では重複排除される
- Organization 単位の report は 2025 年 12 月 12 日 以降
- IDE telemetry がなくても Pull Request metrics が存在する場合がある
⚠️ Metrics は展開、ツール、Enablement の改善に使う。個人の開発者を順位付けするために使わない。