Skip to main content

Copilot使用状況メトリックで使用可能なデータ

Copilot 使用状況メトリック データは、一貫性のあるフィールド セットを使用して、導入、使用状況、およびコード生成アクティビティを表すために、ダッシュボードと API を通じて使用できます。

この機能を使用できるユーザーについて

エンタープライズ所有者、組織管理者、請求管理者、そして「エンタープライズ メトリクスの表示」権限を持つエンタープライズカスタムロールのユーザー。

Copilot 利用状況メトリクス ダッシュボードおよび API では、一貫したフィールド セットを使用してデータを表示およびエクスポートします。 このリファレンスでは、使用可能なすべてのメトリックの一覧を示し、ダッシュボード ビジュアルと NDJSON または API エクスポートの両方で値を解釈する方法について説明します。

  • Copilot 使用状況メトリック ダッシュボードは、 エンタープライズ レベルと 組織 レベルで使用できます。
  • Copilot 使用状況メトリック API は、エンタープライズ レベル、組織レベル、およびユーザー レベルのレコードをサポートします。

これらのメトリックを読み取って解釈する方法のガイダンスについては、 GitHub Copilot 使用状況メトリクス を参照してください。

Copilot の使用状況ダッシュボードのメトリック

これらのメトリックは、Copilot 使用状況ダッシュボードに直接表示されます。 これらのグラフには、Copilot CLI の使用状況は含 まれません

メトリックDescription
エージェントの導入現在の月でCopilotライセンスのアクティブユーザーのうち、エージェントを試したユーザーの割合。
アクティブ ユーザーあたりの平均チャット要求数アクティブ ユーザーあたりのチャット要求の平均数。
コード補完 (推奨/受け入れ済み)表示され、受け入れられたインライン コード候補の合計数。
コード補完の受け入れ率ユーザーが受け入れた提案の割合。
1 日当たりのアクティブ ユーザー特定の日に Copilot を使用した一意のユーザーの数。
週間アクティブ ユーザー7 日間に Copilot を使用した一意のユーザーの数。
アクティブなユーザーの合計数現在のカレンダー月にアクティブなライセンスユーザー。
言語の使用方法Copilot で使用されるプログラミング言語の分布。
1 日あたりの言語使用量使用されている言語の毎日の内訳。
モデルの使用法チャットに使用される AI モデルの配布。
1 日あたりのモデル使用量チャットモデルの使用状況の毎日の内訳。
チャット モードごとのモデルの使用状況Copilot 機能 (質問、編集、プラン、エージェント) に基づくモデルの使用状況。
言語ごとのモデルの使用モデル別に分類された言語の分布。
最もよく使用されるチャット モデル過去 28 日間で最もよく使用されるチャット モデル。
チャット モードあたりの要求数モード別のチャット要求の数 (ask、edit、plan、agent)。

コード生成ダッシュボードのメトリック

これらのメトリックは、コード生成ダッシュボードに表示され、ユーザーが開始したアクティビティとエージェントによって開始されたアクティビティ全体でコードがどのように生成されているかの内訳を示します。 すべての値は、IDE で追加または削除されたコード行 (LoC) から派生します。

メトリックDescription
AI で変更されたコード行過去 28 日間のすべてのモードで追加および削除されたコードの合計行数。
エージェントのコントリビューション過去 28 日間にエージェント (編集、エージェント、カスタム モードを含む) によって追加および削除されたコード行の割合。
エージェントによって削除された平均行数現在のカレンダー月のアクティブ ユーザーに代わってエージェントによって自動的に削除された行の平均数。
追加および削除された行の 1 日あたりの合計各日のすべてのモードで、コードベースに対して追加および削除された行の合計数。
ユーザーによるコード変更コード補完とチャット パネルアクション (挿入、コピー、または適用) を通じてユーザーが提案または手動で追加した行。
エージェントによって開始されるコードの変更編集モード、エージェント モード、およびカスタム モード全体で、ユーザーに代わってエージェントによってコードベースに自動的に追加または削除された行。
モデルごとのユーザーによって開始されたコードの変更IDE で使用されるモデル別にグループ化された、ユーザーが開始するコード行。
モデルごとにエージェントが開始するコード変更エージェントによって開始されるコード行。エージェントアクションを実行するモデル別にグループ化されます。
言語ごとのユーザー開始コードの変更プログラミング言語別にグループ化された、ユーザーが開始するコード行。
言語ごとのエージェントによって開始されるコードの変更エージェントによって開始されるコード行。プログラミング言語別にグループ化されます。

API フィールドとエクスポート フィールド

これらのフィールドは、エクスポートされた NDJSON レポートおよび Copilot 使用状況メトリック API に表示されます。 メトリックに応じて、エンタープライズ、組織、またはユーザースコープで毎日のレコードを提供します。

API によって返されるデータのスキーマの例については、 Copilot 使用状況メトリックのスキーマの例 を参照してください。

フィールドDescription
agent_editCopilot が (エージェントおよび編集モードで) IDE 内のファイルに変更を直接書き込む際に、追加された行と削除された行をキャプチャします。
          `agent_edit` は提案ベースのメトリックに含まれていないため、提案スタイルのフィールド (たとえば、 `user_initiated_interaction_count`) を設定することはできません。 カスタム エージェントからの編集もカウントします。 |

| report_start_day / report_end_day | 28 日間のレポート期間の開始日と終了日。 | | day | このレコードが表すカレンダーの日。 | | enterprise_id | 企業の一意の ID。 | | organization_id (API のみ) | 組織の一意の ID。 | | user_id / user_login | ユーザーの一意の識別子と GitHub ユーザー名。 | | user_initiated_interaction_count | Copilot に送信された明示的なプロンプトの数。

モデルにアクティブに送信されたメッセージまたはプロンプトのみをカウントします。 チャット パネルを開く、モードを切り替える (たとえば、質問、編集、プラン、エージェントなど)、キーボード ショートカットを使用してインライン UI を開く、または構成を変更することは含 まれません 。 | | chat_panel_agent_mode | エージェント モードが選択された状態で、チャット パネルでユーザーが開始した操作をキャプチャします。 | | chat_panel_ask_mode | チャット パネルでユーザーが開始した操作を、Ask モードが選択された状態でキャプチャします。 | | chat_panel_custom_mode | カスタム エージェントが選択された状態で、チャット パネルでユーザーが開始した操作をキャプチャします。 | | chat_panel_edit_mode | 編集モードが選択された状態で、チャット パネルでユーザーが開始した操作をキャプチャします。 | | chat_panel_unknown_mode | モードが不明なチャット パネルでユーザーが開始した操作をキャプチャします。 | | code_generation_activity_count | 生成された個別の Copilot 出力イベントの数。

含む: コメントやドキュメント文字列など、生成されたすべてのコンテンツ。
複数のブロック: 1 人のユーザー プロンプトからの個別のコード ブロックはそれぞれ、個別の生成としてカウントされます。
手記: 1 つのプロンプトで複数の世代を生成できるため、このメトリックは user_initiated_interaction_countと直接比較できません。 | | code_acceptance_activity_count | ユーザーが受け入れる提案またはコード ブロックの数。

カウント: すべての組み込みの受け入れアクション ("ファイルに適用する"、"カーソルに挿入する"、"ターミナルに挿入する"、 コピー ボタンの使用など)。
カウントされません。 OS クリップボードの手動操作 ( Ctrl+C など)。
粒 度: 最初のプロンプトによって生成されたコード ブロックの数に関係なく、受け入れアクションごとにカウントが 1 回インクリメントされます。 | | loc_suggested_to_add_sum | 追加する (入力候補、インライン チャット、チャット パネルなど。エージェントによる編集は除外) ように Copilot が提案したコード行 。 | | loc_suggested_to_delete_sum | 削除するように提案されたコード行 Copilot (今後サポート予定)。 | | loc_added_sum | 実際にエディターに追加されたコード行(受け入れられたコード補完、適用済みコードブロック、エージェント/編集モード)。 | | loc_deleted_sum | エディターから削除されたコード行 (現在、エージェントの編集から)。 | | totals_by_ide | 使用される IDE ごとのメトリックの内訳。 | | totals_by_feature | Copilot 機能別メトリックの内訳 (例: インライン チャット、チャット パネル)。 | | totals_by_language_feature | 言語と特徴のディメンションを組み合わせた内訳。 | | totals_by_model_feature / totals_by_language_model | チャット アクティビティのモデル固有の内訳 (補完ではありません)。 | | last_known_ide_version / last_known_plugin_version | 各ユーザーに対して検出された最新の IDE と Copilot チャット 拡張機能バージョン。 | | daily_active_cli_users | ある特定の日に CLI を介して Copilot を使用した企業内のユニークユーザー数。 このフィールドは、IDE のアクティブなユーザー数に 依存 せず、IDE ベースのアクティブ なユーザー定義には含 まれません 。 その日に CLI を使用しない企業では省略されます。 | | totals_by_cli | 特定の日の企業の CLI 固有のメトリックの内訳。 IDE メトリックに依存しません。CLI の使用は、**** やtotals_by_ideなどの他のフィールドには反映totals_by_feature。 その日に CLI を使用しない企業では省略されます。 以下の Copilot CLI メトリクス フィールドを参照してください。 | | used_cli | ユーザーがその日に Copilot CLI を使用したかどうかをキャプチャします。 | | used_agent | ユーザーがその日に IDE エージェント モードを使用したかどうかをキャプチャします。 | | used_chat | ユーザーがその日に IDE チャットを使用したかどうかをキャプチャします。 |

Copilot CLI メトリクス フィールド (API のみ)

          `totals_by_cli` オブジェクトには、CLI の使用が存在する場合、次の入れ子になったフィールドが含まれます。 これらのメトリックは、現在、エンタープライズ レベルおよびユーザー レベルのレポートでのみ使用できます。
フィールドDescription
totals_by_cli.session_countこの日に開始された個別の CLI セッションの数。
totals_by_cli.request_countこの日に CLI を介して Copilot に対して行われた要求の合計数 (ユーザーが開始したプロンプトとエージェントの自動フォローアップ呼び出しの両方を含む)。
totals_by_cli.token_usage.output_tokens_sumこの日のすべての CLI 要求で生成された出力トークンの合計数。
totals_by_cli.token_usage.prompt_tokens_sumこの日のすべての CLI 要求で送信されたプロンプト トークンの合計数。
totals_by_cli.token_usage.avg_tokens_per_request
          **
          **として計算された CLI 要求あたりの**出力**トークンと`(output_tokens_sum + prompt_tokens_sum) ÷ request_count` トークンの平均数。|

| totals_by_cli.prompt_count | セッション内で実行されたユーザー プロンプト、コマンド、またはクエリの合計数。 | | totals_by_cli.last_known_cli_version | その日にユーザーに対して検出された最新の Copilot CLI バージョン。 |

プル リクエスト アクティビティ フィールド (API のみ)

重要

組織レベルとエンタープライズ レベルのレポートでは、ユーザー重複除去と属性のタイミングの違いにより、合計が異なる場合があります。 スコープ間でのプル要求メトリックの解釈に関するガイダンスについては、 GitHub Copilot 使用状況メトリクス を参照してください。

これらのフィールドは、Copilot によって実行されるアクティビティを含め、エンタープライズまたは組織のスコープでの毎日のプル要求の作成、レビュー、マージ、および提案アクティビティをキャプチャします。

フィールドDescription
pull_requests.total_createdこの特定の日に作成されたプル要求の合計数。

作成は 1 回限りのイベントです。 各プル要求は、作成日にのみカウントされます。
pull_requests.total_reviewedこの特定の日にレビューされたプル要求の合計数。

同じプル要求は、複数の日にレビューを受け取った場合、複数の日にカウントされる可能性があります。 1 日以内に、複数のレビュー アクションが発生した場合でも、各プル要求が 1 回カウントされます。
pull_requests.total_mergedこの特定の日にマージされたプルリクエストの合計数。

マージは 1 回限りのイベントです。 各プル要求は、マージされた日にのみカウントされます。
pull_requests.median_minutes_to_mergeこの特定の日にマージされたプル要求の場合、プル要求の作成からマージまでの中央値 (分単位)。

中央値は、異常に実行時間の長いプル要求からの外れ値の影響を軽減するために使用されます。
pull_requests.total_suggestions作成者に関係なく、この特定の日に生成されたプル要求レビュー候補の合計数。
pull_requests.total_applied_suggestions作成者に関係なく、この特定の日に適用されたプル要求レビュー候補の合計数。
pull_requests.total_created_by_copilotCopilot によってこの特定の日に作成されたプル リクエストの数。
pull_requests.total_reviewed_by_copilotCopilot によってこの特定の日にレビューされたプル リクエストの数。

Copilot が、複数日にわたりレビューした場合、プル リクエストが複数日にわたって関数とされる場合があります。
pull_requests.total_merged_created_by_copilotCopilot によって作成された、この特定の日にマージされたプル要求の数。 各プル要求は、マージされた日にのみカウントされます。
pull_requests.median_minutes_to_merge_copilot_authoredCopilot によって作成され、この特定の日にマージされたプルリクエストにおける、作成からマージまでの平均時間 (分単位)。
pull_requests.total_copilot_suggestionsこの特定の日に Copilot によって生成されたプル要求レビュー候補の数。
pull_requests.total_copilot_applied_suggestionsこの特定の日に適用された Copilot によって生成されたプル要求レビュー候補の数。