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