Thanks to visit codestin.com
Credit goes to docs.github.com

Skip to main content

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

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

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

エンタープライズ所有者、組織管理者、課金マネージャー、"エンタープライズ Copilot メトリックの表示" アクセス許可を持つエンタープライズ カスタム ロールを持つユーザー。

          Copilot使用状況メトリック ダッシュボードと API では、一貫性のある一連のフィールドを使用してデータが表示およびエクスポートされます。 このリファレンスでは、使用可能なすべてのメトリックの一覧を示し、ダッシュボード ビジュアルと NDJSON または API エクスポートの両方で値を解釈する方法について説明します。
  • Copilot使用状況メトリック ダッシュボードは、エンタープライズ レベルと組織レベルで使用できます。
  • Copilot使用状況メトリック API は 、エンタープライズ、組織、およびユーザー レベルのレコードをサポートします。

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

          Copilot 使用状況ダッシュボードの指標

これらのメトリックは、 Copilot 使用状況ダッシュボードに直接表示されます。 これらのグラフには、**** の使用は含Copilot CLI (コパイロット 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_edit
          Copilot (エージェントおよび編集モード) が変更を 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 | チャット アクティビティのモデル固有の内訳 (補完ではありません)。 自動モデルの選択が有効になっている場合、アクティビティは、Autoとして表示されるのではなく、実際に使用されるモデルに起因します。 | | last_known_ide_version / last_known_plugin_version | 各ユーザーに対して検出された最新の IDE および コパイロットチャット 拡張機能バージョン。 | | daily_active_cli_users | 特定の日に CLI を使用して Copilot を使用した企業または組織内の一意のユーザーの数。 このフィールドは、IDE のアクティブなユーザー数に 依存 せず、IDE ベースのアクティブ なユーザー定義には含 まれません 。 その日に CLI を使用しない企業または組織では省略されます。 | | totals_by_cli | 特定の日の企業、組織、またはユーザーの CLI 固有のメトリックの内訳。 IDE メトリックに依存しません。CLI の使用は、**** やtotals_by_ideなどの他のフィールドには反映totals_by_feature。 その日に CLI の使用がない場合は省略されます。 以下のCopilot CLI (コパイロット CLI)メトリック フィールドを参照してください。 | | used_cli | ユーザーがその日 Copilot CLI (コパイロット CLI) 使用したかどうかをキャプチャします。 | | used_agent | ユーザーがその日に IDE でエージェント モードを使用したかどうかをキャプチャします。 Copilotコード レビューとused_copilot_code_review_activeで個別にキャプチャされるused_copilot_code_review_passiveアクティビティは含まれません。 | | used_chat | ユーザーがその日に IDE チャットを使用したかどうかをキャプチャします。 | | used_copilot_code_review_active | ユーザーがその日に Copilotコード レビュー に積極的に関与したかどうかをキャプチャします。 ユーザーが手動で Copilot レビューを要求した場合、または Copilot レビューの提案を適用した場合、ユーザーはアクティブと見なされます。 | | used_copilot_code_review_passive | レビューに積極的に関与することなく、ユーザーがその日の pull request をレビューするために自動的に割り当てられた Copilot かどうかをキャプチャします。 |

          Copilot CLI (コパイロット CLI) metrics フィールド (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 (コパイロット 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_copilotこの特定の日に Copilot によって作成されたプル要求の数。
pull_requests.total_reviewed_by_copilotこの特定の日に Copilot によってレビューされたプル要求の数。

プル要求は、 Copilot が複数の日にレビューした場合、複数の日にカウントされる可能性があります。
pull_requests.total_merged_created_by_copilotこの特定の日にマージされた Copilot によって作成されたプル要求の数。 各プル要求は、マージされた日にのみカウントされます。
pull_requests.median_minutes_to_merge_copilot_authored
          Copilotによって作成され、この特定の日にマージされたプルリクエストの、作成からマージまでの中央値(分単位)。 |

| pull_requests.total_copilot_suggestions | この特定の日に Copilot によって生成された pull request レビュー候補の数。 | | pull_requests.total_copilot_applied_suggestions | この特定の日に適用された Copilot によって生成された pull request レビューの提案の数。 |