Copilot 使用状況の指標について
Copilot の利用状況指標は、主要な利害関係者や意思決定者が、チームがどのようにCopilot を導入・利用しているかを理解するのに役立ちます。 企業全体の使用パターンを追跡することで、エンゲージメントを測定し、価値を高める機会を特定し、AI 支援ワークフローがプル要求のスループットとマージ時間に与える影響を評価できます。
メトリックは、次の方法で使用できます。
- Enterprise、Organization、ユーザーレベルで詳細かつエクスポート可能なデータを提供する Copilot 使用状況メトリック API。
- Copilot 使用状況メトリック ダッシュボード。ここに、Enterprise と Organization 全体の 28 日間の使用状況傾向が視覚化されます。
- コード生成ダッシュボード。企業や組織全体のユーザーとエージェントによってコードがどのように生成されているかが分類されます。
- Copilot 使用状況メトリックの NDJSON 形式でのエクスポートは、カスタム BI ツールや長期保存向けに生データを提供します。
どの使用法が含まれていますか?
Copilot 使用状況メトリックは、IDE および Copilot CLI アクティビティを含む複数の Copilot サーフェスにわたるテレメトリから派生します。 多くのメトリックは IDE テレメトリから取得されるため、 エンド ユーザーはこれらのメトリックに含めるために、IDE でテレメトリを有効にする必要があります。
データには、次のような他の Copilot サーフェスからのアクティビティは含まれません。
- GitHub.com の Copilot チャット
- GitHub Mobile
ライセンスおよびシート管理データは、Copilot 使用状況メトリック レポートには含まれません。 ライセンスの割り当てを表示または管理するには、Copilot ユーザー管理 API を使用します。これは、ライセンスとシート情報の信頼できるソースです。 「Copilotユーザー管理のためのREST APIエンドポイント」を参照してください。
Copilot の使用状況メトリックが API リソース間で異なる理由
次の API リソースでは、Copilot関連のデータが公開されていますが、互換性がないため、直接比較することはできません。 各 API リソースは、特定のユース ケースとデータ モデル用に設計されており、合計またはカバレッジの違いが予想されます。 次の表を使用して、レポートのニーズに最も適した API リソースを理解します。
メモ
Copilot 使用状況メトリック API を使用して、新しい統合と分析を行うことを強くお勧めします。これは、Copilot の使用状況に関する最も完全で将来のビューを提供するためです。
| API リソース | Scope | 主な機能 |
|---|
[AUTOTITLE](/rest/copilot/copilot-usage-metrics) | 高度なエンタープライズ、組織、およびユーザー レベルのイベント テレメトリ | オートコンプリート、チャット、およびエージェント モード全体で統合されたテレメトリを提供します。 すべての IDE モード、言語、モデルの使用状況とコード メトリックの行が含まれます。 機能、IDE、言語、モデル、ユーザー別の詳細な内訳をサポートし、積極的に開発および保守されている主要な API リソースです。 |
|
Copilotユーザー管理のためのREST APIエンドポイント | ライセンスとシートの割り当て | ライセンスの状態、ユーザーの関連付け、last_activity_atなど、Organization または Enterprise に割り当てられた Copilot シートを一覧表示します。 この API リソースは、ライセンスとシート情報の信頼のソースです。 |
|
Copilot メトリックの REST API エンドポイント | エンタープライズ、組織、チームレベルの使用状況メトリック | GitHub.com 上の Copilot の機能 (例えば、プルリクエストの概要) および一部のIDEベースの補完とチャットについて、集計された使用データを提供します。 エージェントまたは編集モードのテレメトリは含まれません。 IDE と言語別のエンタープライズ全体および機能ごとの内訳を提供します。 個々のレベルのデータは含まれません。 |
メトリックは組織全体にどのように属性付けされますか?
メモ
エンタープライズ レベルのアクセス権を提供することなく、Copilot の使用状況メトリックに対して、組織内のみの可視性 を付与できます。
これを行うには、"View organization Copilot metrics" アクセス許可を含む組織のカスタム ロールを作成し、そのロールを 1 つの組織のメトリックを表示する必要があるユーザーに割り当てます。 「カスタム組織ロールの権限」を参照してください。
組織レベル Copilot の使用状況メトリックは、個々のアクションが発生する場所ではなく、組織のメンバーシップに基づいています。 Enterprise のメトリックに表示するには、アクティブな Copilot シートがその Enterprise 内 (Enterprise に属するすべての Organization) に割り当てられている必要があります。 その結果、1 人のユーザーの使用状況が複数の組織ダッシュボードに表示される一方で、同じユーザーはエンタープライズ レベルの合計で 1 回だけカウントされます。 組織レベルの分析は、組織内での導入と使用状況を可視化することを目的としており、エンタープライズ レベルの合計と直接比較するようには設計されていません。
組織レベルのCopilot分析が、2025年12月12日から利用可能です。 これは、組織レベルのレポートが提供される最初の日付です。
ユーザーが企業にシートを持つ場合、シートが割り当てられている場所に関係なく、ユーザーの使用状況は 所属するすべての組織に起因します。
これは、以下のようなことを意味します。
- エンタープライズ内の管理目的で専用の "シェル" 組織にライセンスが割り当てられている場合、ユーザーは、所属する企業内の他のすべての組織のメトリックに引き続き表示されます。
- ユーザーが企業外の別の組織に Copilot シートを持っている場合、 そのアクティビティは、企業 内に少なくとも 1 つのシートがある限り、企業の組織レベルのメトリックに引き続き含まれます。
要するに、ユーザーがメトリックに表示されるようにするには、企業内のどこかでライセンスを取得する必要があります。 その後、メトリックには、Copilot シートやアクティビティの発生元ではなく、作業場所 (Organization メンバーシップ) が反映されます。
サポートされている IDE
Copilot の使用状況メトリックに含めるには、エンド ユーザーは次のいずれかの IDE と Copilot チャット 拡張機能バージョンを使用する必要があります。
| IDE | 最小 IDE バージョン | Copilot チャット 拡張機能の最小バージョン |
|---|---|---|
| Eclipse | 4.31 | 0.9.3.202507240902 |
| JetBrains / IntelliJ | 2024.2.6 | 1.5.52-241 |
| Visual Studio | 17.14.13 | 18.0.471.29466 |
| VS Code | 1.101 | 0.28.0 |
| Xcode | 13.2.1 | 0.40.0 |
データの鮮度
Copilot 使用状況メトリック ダッシュボードと API レポートのデータは、定期的なスケジュールで更新されます。
データは 2 日以内に使用可能になると予想できます。 つまり、特定の日のデータは処理され、その日が閉じた後、完全な UTC 日の 2 日以内に使用できるようになります。
データは何を測定しますか?
Copilot の利用メトリクスは、導入、エンゲージメント、受け入れ率、コード行 (LoC)、プルリクエストライフサイクルメトリクスといういくつかの主要なカテゴリにグループ化できます。
**導入** では、Copilot をアクティブに使用しているライセンスを持つ開発者の数が測定されます。 たとえば、毎日アクティブなユーザー (DAU) は、特定の日に Copilot と対話した一意のユーザーの数を示します。 ロールアウト中に、これらのメトリックに一貫した上昇傾向が表示されるのが理想的です。
**エンゲージメント** 指標では、開発者がCopilotを採用した後にどれだけ深く使用するかを示します。 主要なエンゲージメント メトリックは、使用頻度だけでなく、機能全体の幅も示します。 たとえば、アクティブなユーザーあたりの平均チャット要求数は、ユーザーが Copilot チャット を開いて操作する頻度を測定します。 言語や IDE 間で定期的に増加するチャットの使用を確認する必要があります。
**受け入れ率** は、開発者が Copilotの提案を受け入れる頻度を測定します。 これは、提案が関連性があり、信頼されているかどうかを理解するのに役立ちます。 たとえば、インライン提案の受け入れ率が高い場合は、提案が関連性があり、役に立つことを示します。
**コード行 (LoC) メトリック**は、Copilot がエディターで提案、追加、削除した行数を測定し、Copilot の具体的な出力の傾向を示します。 たとえば、"行の追加" は、実際に受け入れられ、エディターに挿入されたコードの量を示します。
**プル要求ライフサイクル メトリックは** 、Copilot アクティビティがプル要求の結果と配信フローにどのように関連しているかを測定します。 これらのメトリックには、プル要求の作成とマージの数、マージする時間の中央値、提案アクティビティの確認が含まれます。 全体的なプル要求アクティビティと Copilot によって作成されたプル要求を比較することで、AI 支援型ワークフローが組織レベルまたはエンタープライズ レベルでのスループットとサイクル時間に与える影響を評価できます。
スコープ間でのプル要求ライフサイクル メトリックの解釈
プル要求ライフサイクル メトリックは、組織レベルとエンタープライズ レベルの両方で使用できます。 レポートを比較するときは、次の点に注意してください。
-
**重複除去**: エンタープライズ レベルのレポートでは、組織全体のユーザーが重複除去されます。 組織レベルのレポートには含まれません。 -
**Pull request-only data**: pull request data is derived from repository activity. (プル要求データはリポジトリ アクティビティから派生するため)、IDE 使用状況メトリックがない場合でも、プル要求ライフサイクル メトリックが表示されることがあります。 -
**属性のタイミング**: リポジトリまたは組織が所有者間で転送された場合、プル要求の作成、レビュー、マージ イベントは、各イベントが発生したタイミングに応じて異なるエンティティに起因する可能性があります。
これらのメトリックを使用するにはどうすればよいですか?
これらのメトリクスを組み合わせて使用することで、Copilot の使用に関して、チームが抱える重要な疑問に答えることができます。
| Question | これらのメトリックを使用する |
|---|---|
| チームは Copilot を定期的に使用していますか? | 毎日および毎週アクティブなユーザー |
| 最も価値のある機能はどれですか? | チャット モードごとの要求、エージェントの導入 |
| 開発者はCopilotの出力を信頼していますか? | 受け入れ率の傾向 |
| 有効化作業は機能していますか? | トレーニングまたはコミュニケーション キャンペーン後の導入とエンゲージメントの増加 |
| Copilot は配信速度または pull request スループットに影響しますか? | プルリクエストのマージ件数とマージまでの中央値の時間 |
単一の数値に焦点を当てるのではなく、これらの信号全体のパターンを探します。 たとえば、受け入れ率の上昇と組み合わせて安定した DAU は、信頼と価値の増大を示しています。
次のステップ
各 Copilot メトリックが測定する対象とその使用方法を理解したら、ダッシュボードを探索し、これらのメトリックがどのように機能するかを確認できます。
- 企業と組織全体の導入と使用状況の傾向を確認するには、 Copilot 使用状況メトリック ダッシュボードの表示 を参照してください。
- ユーザーとエージェントによってコードがどのように生成されているかを分析するには、 コード生成ダッシュボードの表示 を参照してください。
- Copilot 使用データにプログラムでアクセスするには、Copilot使用状況メトリックの REST API エンドポイント を参照してください。