# ダッシュボード、API、レポート全体での Copilot の使用状況メトリックの調整

Copilot 使用状況メトリックは、基になる同じテレメトリから派生しますが、ダッシュボード、API、エクスポートされたレポート間で集計および表示が異なります。

Copilot 使用状況メトリック ダッシュボード、API、およびエクスポート ファイルはすべて、同じ基になるテレメトリ データを使用しますが、集計と表示方法は異なります。 これらの違いを理解することは、ソース間で数値を調整し、内部レポートを準備するときに分析を信頼するのに役立ちます。

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

## 前提条件

IDE ベースの Copilot の利用状況メトリクスは、**ユーザーの IDE からのテレメトリ**に依存します。 開発者が IDE でテレメトリを無効にした場合、IDE ベースの Copilot アクティビティは、ダッシュボード、API レポート、エクスポートされたデータには表示 **されません** 。

ユーザーが不足しているか、予期せず導入数が少ない場合は、他の原因をトラブルシューティングする前に IDE テレメトリ設定を確認してください。

Copilot 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` 機能 =「エージェント」の場合 | コパイロットエージェント を利用したユーザーを反映します。 |
\| 言語の使用方法 | 言語使用グラフ |
`totals_by_language_feature` または `totals_by_language_model` | ダッシュボードでは、これらの集計フィールドが視覚化されます。 |

フィールドの完全な説明については、 [AUTOTITLE を](/ja/copilot/reference/copilot-usage-metrics)参照してください。

## レポート間の不一致

ダッシュボード データ、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 および拡張機能のバージョンにアップグレードすると減少します。
```