Copilot使用状況メトリック ダッシュボードと API では、一貫性のある一連のフィールドを使用してデータが表示およびエクスポートされます。 このリファレンスでは、使用可能なすべてのメトリックの一覧を示し、ダッシュボード ビジュアルと NDJSON または API エクスポートの両方で値を解釈する方法について説明します。
- Copilot使用状況メトリック ダッシュボードは、エンタープライズ レベルと組織レベルで使用できます。
- Copilot使用状況メトリック API は、エンタープライズまたは組織のスコープでレポートを返し、集計、リポジトリ レベル、および個々のユーザー レベルのレポートの細分性を持ちます。 図形は、スコープと細分性によって異なります。
- チーム レベルのメトリックは事前に集計されません。ユーザー チーム レポートとユーザーごとの使用状況メトリック レポートを結合して作成します。 「チーム レベルのCopilot使用状況メトリック」を参照してください。
- リポジトリ レベルのレポートには、要求された日の pull request アクティビティを含むリポジトリごとに 1 つのレコードが含まれます。 この記事 で後述するリポジトリ レベルのフィールド (API のみ) を参照してください。
これらのメトリックを読み取って解釈する方法のガイダンスについては、 GitHub Copilotの使用状況メトリクス を参照してください。
Copilot 使用状況ダッシュボードの指標
これらのメトリックは、 Copilot 使用状況ダッシュボードに直接表示されます。 これらのグラフには、**** の使用は含Copilot CLI。
| メトリック | Description |
|---|---|
| エージェントの導入 | 現在のカレンダー月にエージェントを試した Copilotライセンスを持つアクティブ ユーザーの割合。 |
| アクティブ ユーザーあたりの平均チャット要求数 | アクティブ ユーザーあたりのチャット要求の平均数。 |
| コード補完 (推奨/受け入れ済み) | 表示され、受け入れられたインライン コード候補の合計数。 |
| コード補完の受け入れ率 | ユーザーが受け入れた提案の割合。 |
| 1 日当たりのアクティブ ユーザー | 特定の日に Copilot を使用した一意のユーザーの数。 |
| 週間アクティブ ユーザー | 7 日間に Copilot を使用した一意のユーザーの数。 |
| アクティブなユーザーの合計数 | 現在のカレンダー月にアクティブなライセンスユーザー。 |
| 言語の使用方法 | |
| Copilotで使用されるプログラミング言語の配布。 | |
| 1 日あたりの言語使用量 | 使用されている言語の毎日の内訳。 |
| モデルの使用法 | チャットに使用される AI モデルの配布。 |
| 1 日あたりのモデル使用量 | チャットモデルの使用状況の毎日の内訳。 |
| チャット モードごとのモデルの使用状況 | |
| Copilot機能 (質問、編集、計画、エージェント) によるモデルの使用状況。 | |
| 言語ごとのモデルの使用 | モデル別に分類された言語の分布。 |
| 最もよく使用されるチャット モデル | 過去 28 日間で最もよく使用されるチャット モデル。 |
| チャット モードあたりの要求数 | モード別のチャット要求の数 (ask、edit、plan、agent)。 |
インパクト ダッシュボードの指標
これらのメトリックは、ユーザーを導入コーホートにグループ化し、その導入をプル要求出力に接続する影響ダッシュボードに表示されます。 導入コーホートの解釈に関するガイダンスについては、 AUTOTITLE を参照してください。
| メトリック | Description |
|---|---|
| エンゲージメントの傾向 | 組織の導入コーホートの組み合わせとプル要求のスループット (1 か月あたりにマージされたプル要求の合計) が過去 6 か月間に変更された方法。 |
| 導入コーホート分布 | 各導入フェーズ (パッシブ ユーザー、フェーズ 1、フェーズ 2、フェーズ 3) にグループ化されたライセンスユーザーの共有。 パッシブ ユーザーは、API の No Cohort 値に対応します。 |
| 導入促進要因 | 積極的なユーザー(フェーズ 1、2、または 3)と受動的なユーザーを、出荷されたコード(ユーザー 1 人あたり月ごとにマージされたプル リクエスト数)およびプル リクエストがマージされるまでの時間で比較し、Copilot のより深い導入による相対的な影響を示します。 |
| 推奨事項 | 組織の現在のコーホート配布に基づいて、 Copilot cloud agent の構成や Copilot code reviewの有効化などの推奨されるアクション。 |
コード生成ダッシュボードのメトリック
これらのメトリックは、コード生成ダッシュボードに表示され、ユーザーが開始したアクティビティとエージェントによって開始されたアクティビティ全体でコードがどのように生成されているかの内訳を示します。 すべての値は、IDE で追加または削除されたコード行 (LoC) から派生します。
| メトリック | Description |
|---|---|
| AI で変更されたコード行 | 過去 28 日間のすべてのモードで追加および削除されたコードの合計行数。 |
| エージェントのコントリビューション | 過去 28 日間にエージェント (編集、エージェント、カスタム モードを含む) によって追加および削除されたコード行の割合。 |
| エージェントによって削除された平均行数 | 現在のカレンダー月のアクティブ ユーザーに代わってエージェントによって自動的に削除された行の平均数。 |
| 追加および削除された行の 1 日あたりの合計 | 各日のすべてのモードで、コードベースに対して追加および削除された行の合計数。 |
| ユーザーによるコード変更 | コード補完とチャット パネルアクション (挿入、コピー、または適用) を通じてユーザーが提案または手動で追加した行。 |
| エージェントによって開始されるコードの変更 | 編集モード、エージェント モード、およびカスタム モード全体で、ユーザーに代わってエージェントによってコードベースに自動的に追加または削除された行。 |
| モデルごとのユーザーによって開始されたコードの変更 | IDE で使用されるモデル別にグループ化された、ユーザーが開始するコード行。 |
| モデルごとにエージェントが開始するコード変更 | エージェントによって開始されるコード行。エージェントアクションを実行するモデル別にグループ化されます。 |
| 言語ごとのユーザー開始コードの変更 | プログラミング言語別にグループ化された、ユーザーが開始するコード行。 |
| 言語ごとのエージェントによって開始されるコードの変更 | エージェントによって開始されるコード行。プログラミング言語別にグループ化されます。 |
API フィールドとエクスポート フィールド
これらのフィールドは、エクスポートされた NDJSON レポートと、 Copilot 使用状況メトリック API に表示されます。 以下のほとんどの表は、フィールド名、その JSON 型、値を null にできるかどうか、および説明を示しています。
レポートの形状は範囲と粒度によって異なるため、レコードで使用できるフィールドは、レポートの取得元によって異なります。
- ユーザーごとのレポート (
*-users-1-dayと*-users-28-day) には、user_id、user_login、ai_credits_used、used_*インジケーター、ai_adoption_phaseなど、ユーザーごとに 1 つのレコードが含まれます。 アクティブ ユーザーの数、pull_requests、またはtotals_by_ai_adoption_phaseは含まれません。 - 集計レポート (
enterprise-1-dayとorg-1-day) には、アクティブユーザー数、pull_requests、totals_by_ai_adoption_phaseなど、企業または組織ごとに 1 つの集計レコードが含まれます。user_id、user_login、またはused_*インジケーターは含まれません。 - 28 日間のレポート (
enterprise-28-dayとorg-28-day) は、day_totalsフィールド内の日次集計レコードの配列をラップし、レポート ウィンドウを最上位に表示します。 - ユーザー チーム レポート (
*-user-teams-1-day) は、所属するチームにユーザーをマップするため、チーム レベルのメトリックを構築できます。 - リポジトリ レベルのレポート (
*-repos-1-day) には、 Copilot cloud agent によって作成され、 Copilot code reviewによってレビューされたプル要求など、その日の pull request アクティビティを含むリポジトリごとに 1 つのレコードが含まれます。
組織範囲のレポートには、organization_idと共にenterprise_idも含まれます。 API によって返されるデータのスキーマの例については、 Copilot使用状況メトリックのスキーマの例 を参照してください。
Type 列では、JSON スキーマの種類 (string、integer、number、boolean、array、およびobject) が使用されます。
Nullable 列は、そのフィールドの値が null であるか、あるいは本来適用されるべきレコードからその値が欠落している可能性があるかどうかを示します。 アクティビティの内訳配列は常に存在しますが、空 ([]) にすることができます。 オプションの配列は nullable としてマークされ、存在しないことがあります。
レポート識別フィールドとパーティションフィールド
これらのフィールドは、各レコードのスコープ、日付、および (エクスポート用) パーティションを識別します。 存在する正確なセットは、レポートの図形によって異なります。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
day | string | いいえ | このレコードが表すカレンダーの日付 ( YYYY-MM-DD 形式)。 28 日間のレポートでは、 day は最上位ではなく、各 day_totals エントリ内に表示されます。 |
enterprise_id | string | いいえ | 企業の一意の ID。 エンタープライズ スコープレポートと組織スコープ レポートの両方に含まれます。 |
organization_id | string | イエス | 組織の一意の ID。 組織範囲のレポートにのみ含まれます。はエンタープライズ スコープのレポートから省略されます。 |
etl_id / day_partition | string | いいえ | ハウスキーピングに使用されるパーティション フィールド。 エクスポートされた NDJSON ファイルに含まれており、使用状況メトリック API によって返されます。 |
entity_id_partition | integer | いいえ | ハウスキーピングに使用されるエンティティ パーティション。 エクスポートされた NDJSON ファイルに含まれており、使用状況メトリック API によって返されます。 |
ユーザーごとのレポート フィールド
ユーザーごとのレポートには、レポート期間のユーザーごとに 1 つのレコードが含まれます。 ユーザーごとの 28 日間のレポートには、レポート ウィンドウをマークする report_start_day と report_end_day も含まれます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
user_id | integer | いいえ | ユーザーを表す一意の識別子です。 |
user_login | string | いいえ | |
| GitHub ユーザーのユーザー名。 | |||
ai_credits_used | number | いいえ | レポート期間中にユーザーが消費した AI クレジットの合計。 このフィールドはユーザーごとのレポートにのみ含まれており、機能、モデル、またはサーフェスごとに分類されません。 このメトリックは、請求の合計ではなく、使用量分析用です。 |
user_initiated_ | integer | いいえ | |
| Copilotに送信された明示的なプロンプトの数。 モデルにアクティブに送信されたメッセージまたはプロンプトのみをカウントします。 チャット パネルを開く、モードを切り替える (たとえば、質問、編集、プラン、エージェントなど)、キーボード ショートカットを使用してインライン UI を開く、または構成を変更することは含 まれません 。 | |||
code_generation_ | integer | いいえ | 生成された個別の Copilot 出力イベントの数。 |
| 含む: コメントやドキュメント文字列など、生成されたすべてのコンテンツ。 | |||
| 複数のブロック: 1 人のユーザー プロンプトからの個別のコード ブロックはそれぞれ、個別の生成としてカウントされます。 | |||
手記: 1 つのプロンプトで複数の世代を生成できるため、このメトリックは user_initiated_と直接比較できません。 | |||
code_acceptance_ | integer | いいえ | ユーザーが受け入れる提案またはコード ブロックの数。 |
| カウント: すべての組み込みの受け入れアクション ("ファイルに適用する"、"カーソルに挿入する"、"ターミナルに挿入する"、 コピー ボタンの使用など)。 | |||
| カウントされません。 OS クリップボードの手動操作 ( Ctrl+C など)。 | |||
| 粒 度: 最初のプロンプトによって生成されたコード ブロックの数に関係なく、受け入れアクションごとにカウントが 1 回インクリメントされます。 | |||
loc_suggested_ | integer | いいえ | 追加が提案されたコード行数 Copilot(補完、インライン チャット、チャット パネルなど。エージェントによる編集は除外) |
loc_suggested_ | integer | いいえ | コード行 Copilot 削除することをお勧めします (今後のサポートが予定されています)。 |
loc_added_sum | integer | いいえ | 実際にエディターに追加されたコードの行数(承認された補完、適用されたコードブロック、エージェント モード、編集モード)。 |
loc_deleted_sum | integer | いいえ | エディターから削除されたコード行 (現在、エージェントの編集から)。 |
used_agent | boolean | いいえ | ユーザーがその日に IDE でエージェント モードを使用したかどうか。 |
Copilot code reviewとused_copilot_で個別にキャプチャされるused_copilot_アクティビティは含まれません。 | |||
used_chat | boolean | いいえ | ユーザーがその日に IDE チャットを使用したかどうか。 |
used_cli | boolean | いいえ | ユーザーがその日 Copilot CLI 使用したかどうか。 |
used_copilot_app | boolean | いいえ | ユーザーがその日に Copilot app を使用したかどうか。 |
used_copilot_ | boolean | いいえ | ユーザーがその日Copilot cloud agent (以前はコーディング エージェントCopilot) を使用したかどうか。 |
used_copilot_ | boolean | いいえ | ユーザーがその日 Copilot cloud agent 使用したかどうか。 |
used_copilot_と同じ値を保持します。両方の名前は下位互換性のために保持されます。 | |||
used_copilot_ | boolean | イエス | ユーザーがその日 Copilot code review 積極的に関与しているかどうか。 ユーザーが手動で Copilot レビューを要求した場合、または Copilot レビューの提案を適用した場合、ユーザーはアクティブと見なされます。 その日にユーザーに Copilot code review シグナルがない場合は null。 |
used_copilot_ | boolean | イエス | ユーザーが、その日に、自ら積極的にレビューに関与することなく、Copilot にその pull request のレビュー担当として自動的に割り当てられていたかどうか。 その日にユーザーに Copilot code review シグナルがない場合は null。 |
ai_adoption_phase | object | いいえ | その日のユーザーの AI 導入フェーズ。 常に存在し、既定では「No Cohort」フェーズになります。 |
| AI 導入フェーズのフィールドを参照してください。 | |||
totals_by_cli | object | イエス | ユーザーの CLI 固有のメトリック。 ユーザーがその日 Copilot CLI 使用しなかった場合は省略されます。 |
| メトリック フィールドCopilot CLI参照してください。 | |||
totals_by_copilot_ | object | イエス | |
| Copilot app ユーザーのメトリック。 ユーザーがその日 Copilot app 使用しなかった場合は省略されます。 | |||
| メトリック フィールドCopilot app参照してください。 | |||
totals_by_3rd_ | array | イエス | 認識された agent appsのエージェントごとの使用状況メトリック。 レポート期間中にユーザーが認識 agent app アクティビティがない場合は省略されます。 |
| メトリック フィールドAgent apps参照してください。 | |||
totals_by_ide | array | いいえ | ユーザーのアクティビティのIDEごとの内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_feature | array | いいえ | ユーザーのアクティビティの機能ごとの内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_language_ | array | いいえ | 言語と特徴のディメンションを組み合わせた内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_language_ | array | いいえ | チャット アクティビティの言語とモデルのディメンションを組み合わせた内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_model_ | array | いいえ | チャット アクティビティのモデルと機能のディメンションを組み合わせた内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 |
集約されたエンタープライズおよび組織のレポート フィールド
集約されたレポートには、企業または組織ごとに 1 つのレコードが含まれています。その日のすべてのユーザーが集計されます。 アクティブ ユーザー数には、クライアント側テレメトリとサーバー側テレメトリの両方で識別されるユーザーが含まれます。 サーバー側のテレメトリによってのみ表示されるユーザーは、アクティブ ユーザーの合計でカウントされますが、ディメンションの内訳配列 (totals_by_ide、 totals_by_featureなど) には表示されない場合があります。 次の表に、アクティブユーザー数、アクティビティの合計、および内訳を示します。
アクティブ ユーザー数:
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
daily_active_ | integer | いいえ | 特定の日に Copilot を使用した一意のユーザーの数。 |
weekly_active_ | integer | いいえ | 末尾の 7 日間に Copilot を使用した一意のユーザーの数。 |
monthly_active_ | integer | いいえ | 末尾の 28 日間に Copilot を使用した一意のユーザーの数。 |
monthly_active_ | integer | いいえ | 末尾の 28 日間にチャットを使用した一意のユーザーの数。 |
monthly_active_ | integer | いいえ | 後続の 28 日間にエージェント モードを使用した一意のユーザーの数。 |
daily_active_ | integer | いいえ | 特定の日に Copilot cloud agent を使用した一意のユーザーの数。 |
weekly_active_ | integer | いいえ | 末尾の 7 日間に Copilot cloud agent を使用した一意のユーザーの数。 |
monthly_active_ | integer | いいえ | 末尾の 28 日間に Copilot cloud agent を使用した一意のユーザーの数。 |
daily_active_ | integer | いいえ | 特定の日に Copilot code review をアクティブに使用した一意のユーザーの数。 アクティブな使用とは、レビューを手動で要求するか、提案を適用することを意味します。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。 |
weekly_active_ | integer | いいえ | 末尾の 7 日間に Copilot code review をアクティブに使用した一意のユーザーの数。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。 |
monthly_active_ | integer | いいえ | 後続の 28 日間に Copilot code review をアクティブに使用した一意のユーザーの数。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。 |
daily_passive_ | integer | いいえ | 特定の日に、プル リクエストのレビュー担当として自動的に Copilot code review が割り当てられたものの、実際にレビューを行わなかったユニーク ユーザー数。 |
weekly_passive_ | integer | いいえ | 過去 7 日間の期間中に、プル リクエストのレビュー担当として自動的に Copilot code review が割り当てられたものの、実際の活動が見られないユニーク ユーザー数。 |
monthly_passive_ | integer | いいえ | 過去 28 日間の期間中に、プル リクエストのレビュー担当として自動的に Copilot code review が割り当てられたものの、実際の活動が見られないユニーク ユーザー数。 |
daily_active_ | integer | イエス | 特定の日に Copilot CLI を使用した一意のユーザーの数。 この数は IDE のアクティブ ユーザー数 に依存 せず、IDE ベースのアクティブ ユーザー定義には含 まれません 。 その日に CLI を使用しない企業または組織では省略されます。 |
daily_active_ | integer | イエス | 特定の日に Copilot app を使用した一意のユーザーの数。 その日、企業または組織に Copilot app アクティビティがない場合は null。 |
アクティビティの合計と内訳:
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
user_initiated_ | integer | いいえ | 1 日のすべてのユーザーに対して Copilot に送信された明示的なプロンプトの合計数。 |
code_generation_ | integer | いいえ | その日のすべてのユーザーに対して生成された個別の Copilot 出力イベントの合計数。 |
code_acceptance_ | integer | いいえ | 1 日のすべてのユーザーに対して受け入れられた提案またはコード ブロックの合計数。 |
loc_suggested_ | integer | いいえ | その日に追加が提案されたコード行数の合計。 ユーザーごとのフィールドと同じ定義。 |
loc_suggested_ | integer | いいえ | その日の削除が推奨される、集計されたコード行。 ユーザーごとのフィールドと同じ定義。 |
loc_added_sum | integer | いいえ | その日の追加コード行数の合計 ユーザーごとのフィールドと同じ定義。 |
loc_deleted_sum | integer | いいえ | 当日に削除されたコード行数の合計。 ユーザーごとのフィールドと同じ定義。 |
totals_by_ide | array | いいえ | IDE ごとのアクティビティの内訳の集計。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_feature | array | いいえ | 機能ごとのアクティビティの内訳の集計。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_language_ | array | いいえ | 集計された言語と機能のアクティビティの内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_language_ | array | いいえ | 集計された言語とモデルのアクティビティの内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_model_ | array | いいえ | 集計されたモデルと機能の活動内訳。 |
| 「アクティビティの内訳オブジェクト」を参照してください。 | |||
totals_by_cli | object | イエス | その日の集計された Copilot CLI メトリック。 その日に CLI の使用がない場合は省略されます。 ユーザーごとのフォームとは異なり、 last_known_cli_は含まれません。 |
| メトリック フィールドCopilot CLI参照してください。 | |||
totals_by_copilot_ | object | イエス | その日の集計された Copilot app メトリック。 その日、企業または組織に Copilot app アクティビティがない場合は null。 |
| メトリック フィールドCopilot app参照してください。 | |||
totals_by_3rd_ | array | イエス | 認識された agent appsのエージェントごとの使用状況メトリックの集計。 その日、企業または組織が認識 agent app アクティビティがない場合は省略されます。 |
| メトリック フィールドAgent apps参照してください。 | |||
totals_by_ai_ | array | イエス | ユーザーとその平均アクティビティのフェーズごとの集計。 導入フェーズのデータが使用できない場合は省略されます。 |
| AI 導入フェーズのフィールドを参照してください。 | |||
pull_requests | object | いいえ | 企業または組織の毎日のプル リクエスト活動。 |
| Pull request アクティビティ フィールドを参照してください。 |
28日間レポートのフィールド
28 日間のレポート (enterprise-28-day と org-28-day) はラッパーであり、最上位レベルのレポート ウィンドウと、毎日集計されたレコードの配列を保持します。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
report_start_day | string | いいえ | 28 日間のレポート期間の最初の暦日(YYYY-MM-DD形式)。 |
report_end_day | string | いいえ | 28 日間のレポート ウィンドウの最後のカレンダー日 ( YYYY-MM-DD 形式)。 |
created_at | string | いいえ | レポートが生成されたときのタイムスタンプ (ISO 8601)。 |
day_totals | array | いいえ | 日次集計レコードの配列。 各エントリには、集計された 1 日レポートと同じフィールドがあります。 |
| 集約されたエンタープライズおよび組織のレポート フィールドを参照してください。 |
ユーザーチームのフィールド
これらのフィールドは、毎日のユーザー チーム レポート (組織およびエンタープライズ スコープの REST API を介して利用可能) に表示され、ユーザーごとの使用状況メトリック レポートと結合してチーム レベルのメトリックを構築するために使用されます。 完全な結合レシピとエンドポイント URL については、 チーム レベルのCopilot使用状況メトリック を参照してください。
特定の日に座っている Copilot ユーザーが 5 人未満のチームは、ユーザー チーム レポートから除外されます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
user_id | integer | いいえ | ユーザーを表す一意の識別子です。 |
user_login | string | いいえ | |
| GitHub ユーザーのユーザー名。 | |||
day | string | いいえ | このレコードが表すカレンダーの日。 |
organization_id | string | いいえ | チームが属している組織の一意の ID。 組織の範囲のみ。 |
enterprise_id | string | いいえ | チームが属している企業の一意の ID。 エンタープライズ スコープのみ。 エンタープライズ スコープのレポートには、エンタープライズ チームとビジネス チームの両方が含まれます。 |
team_id | integer | いいえ | ユーザーが属しているチームの一意の ID。 |
slug | string | いいえ | チームの URL フレンドリ識別子。 |
リポジトリ レベルのフィールド (API のみ)
リポジトリ レベルのレポートには、組織または企業のリポジトリの毎日のプル要求の作成、レビュー、マージ、および提案アクティビティが表示されます。これには、 Copilot cloud agent によって作成され、 Copilot code reviewによってレビューされた pull request が含まれます。 各行は、要求された日にプル要求アクティビティを行った 1 つのリポジトリを表します。アクティビティのないリポジトリは省略されます。 これらのレポートは、プル要求のライフサイクル アクティビティに重点を置き、IDE の使用状況メトリックがない場合でもデータを含めることができます。
これらのフィールドは、組織およびエンタープライズ スコープの REST API を介して使用できる日次リポジトリ レベルのレポート (repos-1-day) によって返されます。 エンドポイント URL、応答エンベロープ、アクセス許可、ダウンロード ワークフローについては、 Copilot使用状況メトリックの REST API エンドポイント を参照してください。 行の例については、 AUTOTITLE を参照してください。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
day | string | いいえ | このレコードが表すカレンダーの日付 ( YYYY-MM-DD 形式)。 |
enterprise_id | string | いいえ | 企業の一意の ID。 エンタープライズ スコープのレポート、そのエンタープライズが所有する組織の組織スコープのレポートに反映されます。 企業が所有していない組織の場合は空です。 |
organization_id | string | いいえ | リポジトリを所有する組織の一意の ID。 エンタープライズ スコープレポートと組織スコープレポートの両方に含まれます。 |
repo_id | integer | いいえ | リポジトリの一意の ID。 |
repo_owner_name | string | いいえ | リポジトリ所有者のログイン。 |
repo_name | string | いいえ | リポジトリ名。 |
repo_visibility | string | いいえ | リポジトリの可視性。 指定できる値は、PRIVATE、INTERNAL、PUBLIC です。 |
pull_requests | object | いいえ | リポジトリの毎日のプル要求アクティビティ。 |
| Pull request アクティビティ フィールドを参照してください。 |
アクティビティの内訳オブジェクト
totals_by_*フィールドは、ブレークダウン オブジェクトの配列です。 配列は常に存在しますが、空にすることができます。 各オブジェクト内で、メトリック フィールド (*_count と loc_*_sum) は、ユーザーごとの最上位レベルのフィールドと同じ定義に従い、ディメンション フィールドには 内訳ディメンションの値に記載されている値が含まれます。
| オブジェクト | ディメンション フィールド | Description |
|---|---|---|
totals_by_ide[] | ide | IDE 別の内訳。 ユーザーごとのレポートでは、各エントリには last_known_ide_ と last_known_plugin_も含まれます。 |
totals_by_feature[] | feature | |
| Copilot機能別の内訳 (インライン チャットやチャット パネルなど)。 | ||
totals_by_language_ | ||
language、feature | 言語と機能を組み合わせた内訳。 | |
user_initiated_は含まれません。 | ||
totals_by_language_ | ||
language、model | チャット アクティビティの言語とモデルを組み合わせた内訳(コンプリーションではありません)。 | |
totals_by_model_ | ||
model、feature | チャットアクティビティの、モデルと機能の組み合わせによる内訳(completions ではありません)。 |
ユーザーごとのレポートでは、各 totals_by_ide[] エントリは、ユーザーに対して最近検出された IDE と Copilot Chat 拡張機能のバージョンも報告します。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
last_known_ide_ | object | イエス | ユーザーに対して検出された最新の IDE バージョン ( { ide_version, sampled_at })。 上限が設定された「その他」のI DE バケットなど、集計された内訳行については省略されます。 |
last_known_ide_ | string | いいえ | IDE バージョン文字列。 |
last_known_ide_が存在する場合に表示されます。 | |||
last_known_ide_ | string | イエス | バージョンのサンプリング時のタイムスタンプ (ISO 8601)。 |
last_known_plugin_ | object | イエス | このユーザーについて検出された最新の Copilot 拡張機能は、{ plugin, plugin_version, sampled_at } です。 集計された内訳行の場合は省略されます。 |
last_known_plugin_ | string | いいえ | 拡張機能の名前 ( copilot や copilot-chatなど)。 |
last_known_plugin_が存在する場合に表示されます。 | |||
last_known_plugin_ | string | いいえ | 拡張機能のバージョン文字列。 |
last_known_plugin_が存在する場合に表示されます。 | |||
last_known_plugin_ | string | イエス | バージョンのサンプリング時のタイムスタンプ (ISO 8601)。 |
Copilot CLI メトリック フィールド
totals_by_cli オブジェクトには、Copilot CLI使用が存在する場合は、次の入れ子になったフィールドが含まれます。CLI の使用がない場合、オブジェクトは省略されます。 CLI の使用は IDE メトリックとは無関係であり、**** やtotals_by_ideなどのフィールドには反映totals_by_feature。
last_known_cli_version オブジェクトは、ユーザーごとのレポートにのみ表示されます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
totals_by_cli.session_ | integer | いいえ | この日に開始された個別の CLI セッションの数。 |
totals_by_cli.request_ | integer | いいえ | この日に CLI を介して Copilot された要求の合計数 (ユーザーが開始したプロンプトとエージェントの自動フォローアップ呼び出しの両方を含む)。 |
totals_by_cli.prompt_ | integer | いいえ | セッション内で実行されたユーザー プロンプト、コマンド、またはクエリの合計数。 |
totals_by_cli.token_ | integer | いいえ | この日のすべての CLI 要求で生成された出力トークンの合計数。 |
totals_by_cli.token_ | integer | いいえ | この日のすべての CLI 要求で送信されたプロンプト トークンの合計数。 |
totals_by_cli.token_ | number | イエス | |
| ** | |||
として計算された CLI 要求あたりの出力**トークンと(output_tokens_ トークンの平均数。 その日に要求がなかった場合は Null。 | |||
totals_by_cli.last_ | object | いいえ | その日にそのユーザーに対して検出された最新のCopilot CLIバージョン({ cli_version, sampled_at }として) ユーザーごとのレポートのみ。 |
totals_by_cli.last_ | string | いいえ | |
Copilot CLI バージョン文字列。 バージョンが検出されなかった場合、デフォルトでは unknown になります。 | |||
totals_by_cli.last_ | string | イエス | バージョンのサンプリング時のタイムスタンプ (ISO 8601)。 |
Copilot app メトリック フィールド
totals_by_copilot_app オブジェクトには、Copilot app使用が存在する場合に、次の入れ子になったフィールドが含まれます。 これは、ユーザーごとのレポートと集約されたエンタープライズ レポートに表示されます。ユーザーまたは企業がその日に Copilot app アクティビティを持っていない場合は、省略されるか null になります。
totals_by_cliとは異なり、Copilot appコーディング アクティビティは、totals_by_feature機能の値の下のtotals_by_model_feature、totals_by_language_feature、totals_by_language_model、およびcopilot_app、および最上位のコード アクティビティとコード行のメトリックにも反映されます。
last_known_app_version フィールドはありません。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
totals_by_copilot_ | integer | いいえ | この日に開始された個別の Copilot app セッションの数。 |
totals_by_copilot_ | integer | いいえ | ユーザーが開始したプロンプトと自動エージェントフォローアップ呼び出しの両方を含む、この日にCopilot経由でCopilot appされた要求の合計数。 |
totals_by_copilot_ | integer | いいえ | セッション内で実行されたユーザー プロンプト、コマンド、またはクエリの合計数。 |
totals_by_copilot_ | integer | いいえ | この日のすべての Copilot app 要求で生成された出力トークンの合計数。 |
totals_by_copilot_ | integer | いいえ | この日のすべての Copilot app 要求に対して送信されたプロンプト トークンの合計数。 |
totals_by_copilot_ | number | イエス | |
(output_tokens_として計算した、Copilot app リクエストあたりの出力トークンとプロンプトトークンの平均。 その日に要求がなかった場合は Null。 |
Agent apps メトリック フィールド
メモ
Agent apps are currently in パブリック プレビュー and subject to change.
totals_by_3rd_party_agent配列には、レポート期間中に使用された認識されたagent appごとに 1 つのエントリが含まれています。 エントリは agent_idごとにグループ化され、同じエージェントにマップされる統合が結合されます。
agent_idを安定したグループ化キーとして使用し、表示用のagent_nameとして使用します。 レポート期間中に認識された agent app アクティビティが使用できない場合、配列は省略されます。
これらのメトリックは、サーバー側のジョブ アクティビティから取得されます。 入れ子になった user_initiated_interaction_count は agent app ジョブ開始をカウントし、同じ名前の最上位フィールドとは区別されます。その最上位フィールドは、他のサポート対象テレメトリからの明示的なプロンプトをカウントします。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
totals_by_3rd_ | string | いいえ | |
agent appの表示名。 名前は変更される可能性があるため、グループ化には agent_id を使用します。 | |||
totals_by_3rd_ | string | いいえ | |
| agent appの安定した識別子。 | |||
totals_by_3rd_ | integer | いいえ | レポート期間中に agent app でユーザーによって開始されたジョブ数。 ジョブの開始ごとにカウントが 1 回インクリメントされます。 |
totals_by_3rd_ | integer | いいえ | レポート期間中にエージェントにマップされた統合の個別の空でないセッション数の合計。 集約された企業および組織のレポートにのみ含まれます。は、ユーザーごとのレポートから省略されます。 |
プル要求のアクティビティ フィールド
重要
組織レベルとエンタープライズ レベルのレポートでは、ユーザー重複除去と属性のタイミングの違いにより、合計が異なる場合があります。 スコープ間でのプル要求メトリックの解釈に関するガイダンスについては、 GitHub Copilotの使用状況メトリクス を参照してください。
pull_requests オブジェクトは、集約されたエンタープライズ レポートと組織レポート、およびリポジトリ レベルのレポートに表示されます。 毎日のプル要求の作成、レビュー、マージ、提案アクティビティ ( Copilot cloud agent と Copilot code reviewによって実行されたアクティビティを含む) がキャプチャされます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
pull_requests.total_ | integer | いいえ | この特定の日に作成されたプル要求の合計数。 作成は 1 回限りのイベントです。 各プル要求は、作成日にのみカウントされます。 |
pull_requests.total_ | integer | いいえ | この特定の日にレビューされたプル要求の合計数。 同じプル要求は、複数の日にレビューを受け取った場合、複数の日にカウントされる可能性があります。 1 日以内に、複数のレビュー アクションが発生した場合でも、各プル要求が 1 回カウントされます。 |
pull_requests.total_ | integer | いいえ | この特定の日にマージされたプルリクエストの合計数。 マージは 1 回限りのイベントです。 各プル要求は、マージされた日にのみカウントされます。 |
pull_requests.median_ | number | イエス | この特定の日にマージされたプル要求の場合、プル要求の作成からマージまでの中央値 (分単位)。 中央値は、異常に実行時間の長いプル要求からの外れ値の影響を軽減するために使用されます。 その日にマージされたプル要求がない場合は、Null となります。 |
pull_requests.total_ | integer | いいえ | 作成者に関係なく、この特定の日に生成されたプル要求レビュー候補の合計数。 |
pull_requests.total_ | integer | いいえ | 作成者に関係なく、この特定の日に適用されたプル要求レビュー候補の合計数。 |
pull_requests.total_ | integer | いいえ | この特定の日に Copilot cloud agent によって作成されたプル要求の数。 |
pull_requests.total_ | integer | いいえ | この特定の日に Copilot code review によってレビューされたプル要求の数。 プル要求は、 Copilot code review が複数の日にレビューした場合、複数の日にカウントされる可能性があります。 |
pull_requests.total_ | integer | いいえ | この特定の日にマージされた Copilot cloud agent によって作成されたプル要求の数。 各プル要求は、マージされた日にのみカウントされます。 |
pull_requests.total_ | integer | いいえ | レポート期間中に Copilot code review によってマージおよびレビューされたプル要求の数。 |
pull_requests.median_ | number | イエス | |
| Copilot cloud agentによって作成され、この特定の日にマージされたプルリクエストの、作成からマージまでの中央値(分単位)。 その日、そのようなプルリクエストが1件もマージされなかった場合はnullです。 | |||
pull_requests.median_ | number | イエス | プル要求の作成とマージの間の中央値 (分単位) は、 Copilot code reviewによってレビューされたプル要求に対してのみ計算されます。 その日、そのようなプルリクエストが1件もマージされなかった場合はnullです。 |
pull_requests.total_ | integer | いいえ | この特定の日に Copilot code review によって生成された pull request レビュー候補の数。 |
pull_requests.total_ | integer | いいえ | この特定の日に適用された Copilot code review によって生成された pull request レビューの提案の数。 |
pull_requests.copilot_ | array | いいえ | 割り当てられたコメントの種類 (Copilot code reviewやsecurityなど) で分類されたbug_risk候補の集計数。 各エントリには、 comment_type、 total_copilot_、および total_copilot_が含まれます。 常に存在しますが、空にすることができます。 |
AI 導入フェーズの分野
Copilot は、ユーザーのアクティビティに基づいて AI 導入フェーズにユーザーをグループ化します。 フェーズ情報は、ユーザーごとの ai_adoption_phase オブジェクトと集計された totals_by_ai_adoption_phase 配列の 2 つの場所に表示されます。 フェーズの値については、内訳の分析コード値を参照してください。
分類ロジック
ユーザーは、関与している Copilot 機能に基づいてフェーズ に分類されます 。 ユーザーは、 後続の 28 日間の時間枠内で少なくとも 2 日間に機能を使用すると、その機能に関与します。 エンゲージメントは、1 日の used_*ユーザー フィールド または code_acceptance_activity_count から直接ではなく、次の表の機能レベルのアクティビティ シグナルから評価されます。 フェーズは上から下に評価され、ユーザーには対象となる最も高いフェーズが割り当てられます。
| Phase | 契約条件 |
|---|---|
| コーホートなし (影響ダッシュボードに "パッシブ ユーザー" として表示されます) | ユーザーは、フェーズの対象となる機能に関与していません。 これは、ユーザーが非アクティブであることを意味するわけではありません。 このグループのユーザーは、引き続き定期的に Copilot を使用し、Premium 要求を使用できますが、後続の 28 日間のうち、少なくとも 2 日間は対象となる機能を使用していません。 最も一般的なケースは、code_completionやagent_editアクティビティを生成しない、chat_panel_agent_として記録されたCopilot Chatまたはエージェント モードの会話的な使用です。 チャット応答からコードをコピーしても、どちらのシグナルも生成されません。 |
| フェーズ 1: 最初にコードを記述する | インライン コード補完 (feature ディメンションのcode_completion値) や、ファイルに直接書き込まれたエージェント編集 (feature ディメンションのagent_edit値) に関与します。 |
| フェーズ 2: エージェント優先 | |
feature(GitHub ディメンションの copilot_cli 値)、used_copilot_(Copilot CLI)、または used_copilot_(used_copilot_ または Copilot cloud agent)のうち、Copilot code review ベースのエージェント サーフェスをちょうど 1 つ操作した アクティブとパッシブの Copilot code review は、1 つのサーフェスとしてまとめてカウントされます。 | |
| フェーズ 3: マルチエージェント | |
Copilot app(copilot_app 寸法の feature 値)と係合している、またはフェーズ 2 に記載されているエージェント サーフェスのうち 2 つ以上と係合している。 |
そのフェーズに到達するには、ユーザーがフェーズ独自の信号に関与するだけで済みます。 ユーザーはフェーズ 2 またはフェーズ 3 に到達するためにフェーズ 1 の条件を個別に満たす必要はありませんが、実際にはエージェントサーフェスの使用は、多くの場合、完了やエージェントの編集と同時に行われます。
エージェント サーフェスのうち、ユーザーの AI 導入フェーズに影響を与えるのは、表に示されているファースト パーティのサーフェスのみです。 パートナーが構築した agent apps からのアクティビティは、フェーズには影響しません。 同じ分類ロジックは、1 日および 28 日間のレポートを含む、企業および組織のレポートにも適用されます。
メモ
分類では機能レベルのエンゲージメントが使用されるため、一部のアクティビティはユーザーのフェーズに単独では影響しません。 IDE チャット (used_chat) またはエージェント モード (used_agent) を使用しても、 code_completion または agent_edit アクティビティが生成されない限り、ユーザーはフェーズ 1 の対象になりません。
たとえば、エージェントモードで agent_edit にファイルを編集させずに質問すると、記録されるのは chat_panel_agent_mode のアクティビティであり、Copilot ではありません。 このように利用がすべて会話形式であるユーザーは、実際に Copilot を使用しており、プレミアム リクエストの使用が発生する可能性がある場合でも、No Cohort グループにとどまります。 同様に、 code_acceptance_activity_count には、"ファイルに適用" や [コピー ] ボタンなど、インライン code_completion アクティビティではないチャット ベースの同意が含まれているため、分類には使用されません。
featureディメンションの詳細については、「内訳ディメンションの値」を参照してください。
フェーズの割り当ては、末尾の 28 日間のウィンドウを使用して毎日再計算されるため、ユーザーのフェーズは、ウィンドウ内のアクティビティが変化するにつれて 1 日から次の日に変更できます。 これは予期される動作であり、データ エラーを示すものではありません。
ユーザーごとの ai_adoption_phase オブジェクトには、次のものが含まれます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
ai_adoption_phase.phase_ | integer | いいえ | 数値フェーズ識別子 ("No Cohort" の 0 など)。 |
ai_adoption_phase.phase | string | いいえ | 人間が判読できるフェーズ名。 |
ai_adoption_phase.version | string | いいえ | 使用される導入フェーズ モデルのバージョン (たとえば、 v1)。 |
集計された totals_by_ai_adoption_phase 配列内の各エントリには、次のものが含まれます。
| フィールド | タイプ | ヌラブル | Description |
|---|---|---|---|
phase | string | いいえ | 人間が判読できるフェーズ名。 |
phase_number | integer | いいえ | 数値フェーズ識別子。 |
total_engaged_ | integer | いいえ | 期間にこのフェーズにグループ化されたユーザーの数。 |
avg_user_initiated_ | number | いいえ | このフェーズにおける、ユーザー1人当たりのユーザー開始インタラクションの平均回数。 |
avg_code_generation_ | number | いいえ | このフェーズのユーザーあたりの平均コード生成アクティビティ。 |
avg_code_acceptance_ | number | いいえ | このフェーズのユーザーあたりの平均コード受け入れアクティビティ。 |
avg_loc_added | number | いいえ | このフェーズでユーザーごとに追加されたコードの平均行。 |
avg_loc_deleted | number | いいえ | このフェーズでユーザーごとに削除されたコードの平均行数。 |
avg_pull_requests_ | number | いいえ | このフェーズでユーザーごとに確認された平均プル要求数。 |
avg_pull_requests_ | number | いいえ | このフェーズでユーザーごとに作成された平均プル要求数。 |
avg_pull_requests_ | number | いいえ | このフェーズにおけるユーザーごとのマージ済みプルリクエストの平均数。 |
total_pull_requests_ | integer | いいえ | このフェーズでユーザーによってマージされたプル要求の合計数。 組織日別およびエンタープライズ日別の集計レポートに適用されます。 |
avg_pull_requests_ | number | いいえ | このフェーズの各ユーザーにおける、マージまでの時間(分)の中央値の平均。 |
avg_pull_requests_ | number | いいえ | プル リクエストの作成から最初のレビューまでの時間の中央値(分)。対象はマージされたプル リクエストに限定され、プル リクエストのマージ日に基づいて計上されます。 |
avg_pull_requests_ | number | いいえ | プル要求あたりのレビュー送信数 (レビュー サイクル数) の中央値。マージされたプル要求にスコープが設定され、プル要求のマージ日に起因します。 |
内訳の分析コード値
上記のブレークダウン オブジェクトでは、固定セットからの値を持つディメンション フィールドが使用されます。 これらはフィールド 値であり、個別のフィールドではありません。 たとえば、 agent_edit と chat_panel_*_mode の値は、最上位のフィールドではなく、 feature フィールドの値です。
featureディメンションは、アクティビティが属性付けされるCopilot機能またはモードを識別します。
| 価値 | Description |
|---|---|
code_completion | インラインコード補完。 |
chat_inline | エディターでのインライン チャット。 |
chat_panel_ask_ | Ask モードを選択した状態でのチャット パネルの操作。 |
chat_panel_edit_ | 編集モードが選択されたチャット パネルの操作。 |
chat_panel_agent_ | エージェント モードが選択されたチャット パネルの操作。 |
chat_panel_plan_ | プラン モード選択時のチャット パネルの操作。 |
chat_panel_custom_ | 選択したカスタム エージェントとのチャット パネルの操作。 |
chat_panel_unknown_ | モードが不明なチャット パネルの操作。 |
agent_edit | |
| Copilot (エージェントおよび編集モード) で IDE 内のファイルに変更を直接書き込むと、行が追加および削除されます。 カスタム エージェントからの編集もカウントします。 | |
agent_edit は提案ベースのメトリックには含まれません。また、 user_initiated_など、提案スタイルのフィールドを設定することはできません。 | |
copilot_cli | |
| Copilot CLIに起因するアクティビティ。 | |
copilot_app | |
| Copilot アプリに起因するアクティビティ。 | |
others | 上記の値でカバーされていない機能。 |
ide ディメンションは、アクティビティが発生した IDE を識別します。 これは網羅的なリストではありませんが、観察される値の例には、 vscode、 visualstudio、 intellij、 eclipse、 xcode、 neovim、 vim、 emacs、および zedが含まれます。
model ディメンションは、チャット アクティビティに使用される AI モデルを識別します。 値には、特定のモデル識別子 ( gpt-5.4 や claude-sonnet-4.6など)、 auto、 unknown、 othersが含まれます。
auto値は、auto model selectionが使用され、要求が特定のモデルに属性付けされなかったアクティビティを表します。
phaseディメンションは、ユーザーがグループ化される AI 導入フェーズ (No Cohort、Phase 1、Phase 2、またはPhase 3) を識別します。