{"meta":{"title":"ダッシュボード、API、レポート全体での Copilot の使用状況メトリックの調整","intro":"Copilot 使用状況メトリックは、基になる同じテレメトリから派生しますが、集計され、ダッシュボード、API、エクスポートされたレポート間で異なる方法で表示されます。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/reference","title":"リファレンス"},{"href":"/ja/copilot/reference/copilot-usage-metrics","title":"Copilot の使用状況メトリック"},{"href":"/ja/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics","title":"Copilot の使用状況メトリックの調整"}],"documentType":"article"},"body":"# ダッシュボード、API、レポート全体での Copilot の使用状況メトリックの調整\n\nCopilot 使用状況メトリックは、基になる同じテレメトリから派生しますが、集計され、ダッシュボード、API、エクスポートされたレポート間で異なる方法で表示されます。\n\nCopilot使用状況メトリック ダッシュボード、API、エクスポート ファイルはすべて同じ基になるテレメトリ データを使用しますが、集計と表示方法は異なります。 これらの違いを理解することは、ソース間で数値を調整し、内部レポートを準備するときに分析を信頼するのに役立ちます。\n\n* Copilot使用状況メトリック ダッシュボードは、**エンタープライズ** レベルと**組織**レベルで使用できます。\n* Copilot使用状況メトリック API は **、エンタープライズ、組織、リポジトリ、およびユーザー レベルのレコードを**サポートします。\n* チーム レベルの合計は事前に集計されません。 これらは、ユーザー チーム レポートとユーザーごとの使用状況メトリック レポートを結合することによって構築されます。 「[チーム レベルのCopilot使用状況メトリック](/ja/copilot/reference/copilot-usage-metrics/team-level-metrics)」を参照してください。\n* リポジトリ レベルのレポートは、要求された日のアクティビティを含むリポジトリの毎日のプル要求アクティビティを提供します。 「[Copilot使用状況メトリックで使用可能なデータ](/ja/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#repository-level-fields-api-only)」を参照してください。\n\n## 前提条件\n\nIDE ベースの Copilot 使用状況メトリックは、 **ユーザーの IDE からのテレメトリ**によって異なります。 開発者が IDE でテレメトリを無効にした場合、IDE ごと、機能ごと、コード行の内訳など、IDE ベースの詳細な Copilot アクティビティは、ダッシュボード、API レポート、エクスポートされたデータには表示 **されません** 。 ただし、サーバー側のテレメトリでは、クライアント テレメトリが使用できない場合でも、アクティブなユーザー数でこれらのユーザーが表示される可能性があります。\n\nユーザーが不足しているか、予期せず導入数が少ない場合は、他の原因をトラブルシューティングする前に IDE テレメトリ設定を確認してください。\n\nCopilot CLI メトリック (`daily_active_cli_users` と `totals_by_cli`) は、IDE テレメトリとは別に収集および報告されます。 CLI の使用は、IDE ベースのアクティブなユーザー数やその他の IDE メトリックには影響 **しません** 。\n\nユーザー起点の agent app ジョブをカウントする `totals_by_3rd_party_agent[].user_initiated_interaction_count` を、サポート対象の他のテレメトリからの明示的なプロンプトをカウントする最上位レベルの `user_initiated_interaction_count` と照合しないでください。\n\n## メトリックの位置合わせ\n\nダッシュボードと API は、主なメトリックに共有定義を使用します。\n\n| 概念                                                                  | ダッシュボードの指標                                                                                                                                                                                                                                             | API またはエクスポート フィールド | 注記 |\n| :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------ | :- |\n| アクティブ ユーザー                                                          | 毎日/毎週/アクティブなユーザーの合計数                                                                                                                                                                                                                                   |                     |    |\n| `user_initiated_interaction_count` ＞ 0                              | ユーザーがその日に IDE で Copilot と対話した場合、ユーザーはアクティブと見なされます。                                                                                                                                                                                                     |                     |    |\n| 受け入れ率                                                               | コード補完の受け入れ率                                                                                                                                                                                                                                            |                     |    |\n| `code_acceptance_activity_count` ÷ `code_generation_activity_count` | どちらのソースも同じ方法で受け入れ率を計算しますが、丸めは異なる場合があります。                                                                                                                                                                                                               |                     |    |\n| エージェントの導入                                                           | エージェント導入チャート                                                                                                                                                                                                                                           |                     |    |\n| `totals_by_feature` 機能 =「エージェント」の場合                                 |                                                                                                                                                                                                                                                        |                     |    |\n| Copilot agentを操作したユーザーを反映します。                                       |                                                                                                                                                                                                                                                        |                     |    |\n| 言語の使用方法                                                             | 言語使用グラフ                                                                                                                                                                                                                                                |                     |    |\n| `totals_by_language_feature` または `totals_by_language_model`         | ダッシュボードでは、これらの集計フィールドが視覚化されます。                                                                                                                                                                                                                         |                     |    |\n| 導入グループ/フェーズ                                                         | 導入コーホート分布（影響ダッシュボード）                                                                                                                                                                                                                                   |                     |    |\n| `ai_adoption_phase`、`totals_by_ai_adoption_phase`                   | フェーズ定義は共通ですが、対象集団は異なります。 ダッシュボードには、後続の 28 日間のウィンドウでアクティブなすべてのユーザーが含まれますが、集計された `totals_by_ai_adoption_phase` フィールドには、レコードの特定の日にアクティブなユーザーがカウントされます。 そのため、ダッシュボードと API のコーホートの数と割合が一致しません。 ダッシュボードに \"パッシブ ユーザー\" として表示されるユーザーは、 `No Cohort` API 値に対応します。 |                     |    |\n\nフィールドの完全な説明については、 [AUTOTITLE を](/ja/copilot/reference/copilot-usage-metrics)参照してください。\n\n## レポート間の不一致\n\nダッシュボード データ、API レポート、エクスポートの間には小さな違いが予想されます。 これらのバリエーションは、通常、時間枠、スコープ、またはデータの鮮度の違いが原因で発生します。\n\n### 時間枠\n\nデータ ソースごとに異なる方法でデータが集計されます。\n\n| 情報源                          | 時間枠               | 集計メソッド                                     |\n| :--------------------------- | :---------------- | :----------------------------------------- |\n| Dashboard                    | 28 日間のローリング ウィンドウ | メトリックは、過去 28 日間にわたって継続的に集計され、変動がスムーズになります。 |\n| API（アプリケーションプログラミングインターフェース） | 毎日                | 各レコードはユーザーごとに 1 日を表し、毎日の傾向分析を有効にします。       |\n| NDJSON のエクスポート               | 毎日                | BI ツールと長期的なレポート用の API 出力をミラー化します。          |\n\nレポート期間をダッシュボードの 28 日間のウィンドウに合わせて調整すると、ほとんどの比較の一貫性が高くなります。 ただし、ダッシュボードはウィンドウ全体で個別のユーザーをカウントし、集計された API フィールドには日単位のカウントが含まれているため、導入コーホート数は一致しません。\n\n### 遅延テレメトリ\n\nIDE テレメトリは非同期的に処理されるため、最近のデータが不完全または不足している可能性があります。 通常、データは完全な UTC 日の 3 日以内に最終処理されます。 最近の毎日のメトリックの明らかな低下は、テレメトリが完全に処理されると解決されることがよくあります。\n\n### エクスポートのタイミング\n\nNDJSON ファイルには、エクスポート時に使用可能なデータが反映されます。 新しいテレメトリが処理される前にファイルがダウンロードされると、データがダッシュボードまたは API に遅れる可能性があります。 3 日間のウィンドウの後にファイルを再エクスポートすると、最も正確なビューが表示されます。\n\n## `Unknown` 値\n\n値 `Unknown` は、IDE クライアントからのテレメトリがアクティビティを分類するための十分な詳細を欠いている場合、一部の API またはエクスポート分解に現れます。 これは予期される動作であり、データの不足を示すものではありません。\n\n| 詳細       | Explanation                                                                                                                  |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------- |\n| Language | IDE がアクティブ ファイルのプログラミング言語を識別できない場合に `Unknown` として表示されます。                                                                     |\n| 特徴       | 古いクライアントがチャット モードを指定せずに汎用イベントを送信すると表示されます (たとえば、 `chat_panel_unknown_mode`)。                                                 |\n| モデル      | イベントに使用されるモデルを識別する情報がない場合に表示されます。 一部の内部モデル (たとえば、 `gpt-4o-mini`) は、概要作成や意図検出などのユーザー向け以外の操作に使用すると、 `Unknown` と共に表示される場合があります。 |\n\n`Unknown` 値はダッシュボードの視覚化から除外されますが、API と NDJSON のデータには完全に表示されます。\n`Unknown` データの量は、ユーザーが、より豊富なテレメトリを送信する新しい IDE および拡張機能のバージョンにアップグレードすると減少します。\n\n## サーバー側テレメトリによって表示されるユーザー\n\nCopilot 使用状況メトリックは、クライアント側とサーバー側のテレメトリを組み合わせてアクティブなユーザーを識別します。 サーバー側のテレメトリを通じてアクティブと確認されたユーザーが、クライアント テレメトリを受信しなかったユーザーは、アクティブなユーザーの合計 ( `daily_active_users` など) に含まれます。 使用可能な場合、これらのユーザーは `totals_by_ide` にも表示されることがあります (また、ユーザーごとのレポートには、最近検出された IDE と Copilot 拡張機能のバージョンが含まれます)。 ただし、他のディメンションの内訳 (`totals_by_feature`、 `totals_by_language_feature`、 `totals_by_language_model`、 `totals_by_model_feature`) とコード行のメトリックは空のままです。\n\nつまり、最上位レベルのアクティブなユーザー数は、ブレークダウン配列に反映されたユーザーの合計よりも多い可能性があります。 これは予期される動作であり、データ エラーを示すものではありません。"}