Skip to main content

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

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

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

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

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

  • Copilot使用状況メトリック ダッシュボードは、エンタープライズ レベルと組織レベルで使用できます。
  • Copilot使用状況メトリック API は 、エンタープライズ、組織、およびユーザー レベルのレコードをサポートします。
  • チーム レベルのメトリックは事前に集計されません。ユーザー チーム レポートとユーザーごとの使用状況メトリック レポートを結合して作成します。 「チーム レベルのCopilot使用状況メトリック」を参照してください。

これらのメトリックを読み取って解釈する方法のガイダンスについては、 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_day28 日間のレポート期間の開始日と終了日。
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_plan_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 を使用しない企業または組織では省略されます。
daily_active_copilot_code_review_users特定の日に Copilotコード レビュー をアクティブに使用した一意のユーザーの数。 アクティブな使用とは、レビューを手動で要求するか、提案を適用することを意味します。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
daily_passive_copilot_code_review_users特定の日に、プル リクエストのレビュー担当として自動的に Copilotコード レビュー が割り当てられたものの、実際にレビューを行わなかったユニーク ユーザー数。
weekly_active_copilot_code_review_users末尾の 7 日間に Copilotコード レビュー をアクティブに使用した一意のユーザーの数。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
weekly_passive_copilot_code_review_users過去 7 日間の期間中に、プル リクエストのレビュー担当として自動的に Copilotコード レビュー が割り当てられたものの、実際の活動が見られないユニーク ユーザー数。
monthly_active_copilot_code_review_users後続の 28 日間に Copilotコード レビュー をアクティブに使用した一意のユーザーの数。 ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
monthly_passive_copilot_code_review_users過去 28 日間の期間中に、プル リクエストのレビュー担当として自動的に Copilotコード レビュー が割り当てられたものの、実際の活動が見られないユニーク ユーザー数。
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その日、ユーザーがプル リクエストのレビューに Copilot を自動的に割り当てられたものの、実際にレビューには関与しなかったかどうかを記録します。

Copilot CLI (コパイロット 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 (コパイロット 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.total_merged_reviewed_by_copilotレポート期間中に Copilotコード レビュー によってマージおよびレビューされたプル要求の数。
pull_requests.median_minutes_to_merge_copilot_authored
Copilotによって作成され、この特定の日にマージされたプルリクエストの、作成からマージまでの中央値(分単位)。
pull_requests.median_minutes_to_merge_copilot_reviewedプル要求の作成とマージの間の中央値 (分単位) は、 Copilotコード レビューによってレビューされたプル要求に対してのみ計算されます。
pull_requests.total_copilot_suggestionsこの特定の日に Copilot によって生成された pull request レビュー候補の数。
pull_requests.total_copilot_applied_suggestionsこの特定の日に適用された Copilot によって生成された pull request レビューの提案の数。
pull_requests.copilot_suggestions_by_comment_type割り当てられたコメントの種類 (CopilotやCopilotなど) に基づいて分類されるコードレビューの提案の集計数。 各エントリには、 comment_typetotal_copilot_suggestions、および total_copilot_applied_suggestionsが含まれます。 リポジトリ レベルでは使用できません。

ユーザー チーム フィールド (API のみ)

これらのフィールドは、毎日のユーザー チーム レポート (組織およびエンタープライズ スコープの REST API を介して利用可能) に表示され、ユーザーごとの使用状況メトリック レポートと結合してチーム レベルのメトリックを構築するために使用されます。 完全な結合レシピとエンドポイント URL については、 チーム レベルのCopilot使用状況メトリック を参照してください。

特定の日に座っている Copilot ユーザーが 5 人未満のチームは、ユーザー チーム レポートから除外されます。

フィールドDescription
user_id / user_loginユーザーの一意の識別子と GitHub ユーザー名。
dayこのレコードが表すカレンダーの日。
organization_id (組織のスコープ)チームが属している組織の一意の ID。
enterprise_id(エンタープライズ向けの範囲)チームが属している企業の一意の ID。 エンタープライズ スコープのレポートには、エンタープライズ チームとビジネス チームの両方が含まれます。
team_idユーザーが属しているチームの一意の ID。
slugチームの URL フレンドリ識別子。