# 대시보드, API 및 보고서에서 Copilot 사용량 메트릭 조정

Copilot 사용 메트릭은 동일한 기본 원격 분석에서 파생되지만 대시보드, API 및 내보낸 보고서에서 다르게 집계되고 표시됩니다.

사용 메트릭 대시보드, API 및 내보내기 파일은 Copilot 모두 동일한 기본 원격 분석 데이터를 사용하지만 집계하고 다르게 표시합니다. 이러한 차이점을 이해하면 원본 간에 숫자를 조정하고 내부 보고서를 준비할 때 분석을 신뢰할 수 있습니다.

* Copilot 사용 메트릭 대시보드는 **엔터프라이즈** 및 **조직** 수준에서 사용할 수 있습니다.
* 사용 메트릭 API는 Copilot**엔터프라이즈, 조직, 리포지토리 및 사용자 수준 레코드를** 지원합니다.
* 팀 수준 합계는 미리 집계되지 않습니다. 사용자별 사용 메트릭 보고서와 사용자 팀 보고서를 조인하여 생성됩니다.
  [팀 수준의 Copilot 사용 지표](/ko/copilot/reference/copilot-usage-metrics/team-level-metrics)을(를) 참조하세요.
* 리포지토리 수준 보고서는 요청된 날짜에 활동이 있는 리포지토리에 대한 일일 끌어오기 요청 작업을 제공합니다.
  [Copilot 사용 메트릭에서 사용할 수 있는 데이터](/ko/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#repository-level-fields-api-only)을(를) 참조하세요.

## 전제 조건

IDE 기반 Copilot 사용 메트릭은 **사용자의 IDE에서 원격 분석에** 따라 달라집니다. 개발자가 IDE에서 원격 분석을 사용하지 않도록 설정한 경우 IDE별, 기능별 및 코드 줄 분석과 같은 자세한 IDE 기반 Copilot 작업은 대시보드, API 보고서 또는 내보낸 데이터에 표시되지 **않습니다** . 그러나 클라이언트 원격 분석을 사용할 수 없는 경우에도 서버 쪽 원격 분석은 활성 사용자 수에서 이러한 사용자를 표시할 수 있습니다.

누락된 사용자 또는 예기치 않게 낮은 채택 수가 발견되면 다른 원인을 해결하기 전에 IDE 원격 분석 설정을 확인합니다.

Copilot CLI 메트릭(`daily_active_cli_users` 및 `totals_by_cli`)은 IDE 원격 분석과 별도로 수집 및 보고됩니다. CLI 사용은 IDE 기반 활성 사용자 수 또는 기타 IDE 메트릭에 영향을 **주지** 않습니다.

사용자가 시작한 agent app 작업 수를 집계하는 `totals_by_3rd_party_agent[].user_initiated_interaction_count`를, 지원되는 다른 텔레메트리의 명시적 프롬프트 수를 집계하는 최상위 `user_initiated_interaction_count`와 조정하지 마세요.

## 메트릭 정렬

대시보드 및 API는 주요 메트릭에 공유 정의를 사용합니다.

| 개념                                                                  | 대시보드 지표                                                                                                                                                                                                                          | API 또는 내보내기 필드 | 비고 |
| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------- | :- |
| 활성 사용자                                                              | 매일/매주/총 활성 사용자                                                                                                                                                                                                                   |                |    |
| `user_initiated_interaction_count` > 0                              | 사용자는 해당 일에 IDE에서 Copilot와 상호 작용한 경우 활성 사용자로 간주됩니다.                                                                                                                                                                               |                |    |
| 수락률                                                                 | 코드 완성 수락률                                                                                                                                                                                                                        |                |    |
| `code_acceptance_activity_count` ÷ `code_generation_activity_count` | 반올림은 다를 수 있지만 두 소스 모두 동일한 방식으로 수용률을 계산합니다.                                                                                                                                                                                       |                |    |
| 에이전트 도입                                                             | 에이전트 채택 차트                                                                                                                                                                                                                       |                |    |
| `totals_by_feature` 기능 = "agent"인 경우                                |                                                                                                                                                                                                                                  |                |    |
| Copilot agent와 상호 작용한 사용자를 반영합니다.                                   |                                                                                                                                                                                                                                  |                |    |
| 언어 사용                                                               | 언어 사용 현황 차트                                                                                                                                                                                                                      |                |    |
| `totals_by_language_feature` 또는 `totals_by_language_model`          | 대시보드는 이러한 집계된 필드를 시각화합니다.                                                                                                                                                                                                        |                |    |
| 채택 집단/단계                                                            | 도입 코호트 분포(영향 대시보드)                                                                                                                                                                                                               |                |    |
| `ai_adoption_phase`, `totals_by_ai_adoption_phase`                  | 단계 정의는 공유되지만 모집단은 다릅니다. 대시보드에는 후행 28일 기간 동안 활성 상태인 모든 사용자가 포함되며 집계된 `totals_by_ai_adoption_phase` 필드는 레코드의 특정 날짜에 활성 상태인 사용자 수를 계산합니다. 따라서 대시보드 및 API 코호트 수와 백분율이 일치하지 않습니다. 대시보드에 "수동 사용자"로 표시되는 사용자는 API 값에 `No Cohort` 해당합니다. |                |    |

전체 필드 설명은 [GitHub Copilot 사용 메트릭](/ko/copilot/reference/copilot-usage-metrics)을 참조하세요.

## 보고서 간 불일치

대시보드 데이터, API 보고서 및 내보내기 간의 작은 차이가 예상됩니다. 이러한 변형은 일반적으로 시간 창, 범위 또는 데이터 새로 고침의 차이로 인해 발생합니다.

### 기간

각 데이터 원본은 데이터를 다르게 집계합니다.

| 출처          | 시간 범위      | 집계 메서드                                       |
| :---------- | :--------- | :------------------------------------------- |
| Dashboard   | 28일 롤링 윈도우 | 메트릭은 원활한 변동을 위해 지난 28일 동안 지속적으로 집계됩니다.       |
| API들        | Daily      | 각 레코드는 사용자당 일별을 나타내며, 일일 추세 분석을 사용하도록 설정합니다. |
| NDJSON 내보내기 | Daily      | BI 도구 및 장기 보고에 대한 API 출력을 미러링합니다.            |

보고 기간을 대시보드의 28일 기간에 맞추면 대부분의 비교가 더 일관됩니다. 그러나 대시보드가 창 전체에서 고유한 사용자 수를 계산하고 집계된 API 필드에 일일 수가 포함되어 있으므로 채택 코호트 수가 일치하지 않습니다.

### 지연된 원격 분석

IDE 원격 분석은 비동기적으로 처리되므로 최근 일의 데이터가 불완전하거나 누락된 것처럼 보일 수 있습니다. 데이터는 일반적으로 3일 이내에 완료됩니다. 최근 일일 메트릭의 명백한 하락은 원격 분석이 완전히 처리되면 종종 해결됩니다.

### 내보내기 타이밍

NDJSON 파일은 내보내기 시 사용할 수 있는 데이터를 반영합니다. 새 원격 분석이 처리되기 전에 파일을 다운로드하는 경우 데이터가 대시보드 또는 API보다 뒤쳐질 수 있습니다. 3일 기간 후에 파일을 다시 내보내면 가장 정확한 보기가 제공됩니다.

## `Unknown` 값

일부 API 또는 내보내기 분석에서 "값 `Unknown`"은 IDE 클라이언트의 테레메트리가 활동을 범주화하기에 충분한 세부 정보를 제공하지 않을 때 나타납니다. 이 동작은 예상된 동작이며 누락된 데이터를 나타내지 않습니다.

| 분석       | Explanation                                                                                                                 |
| :------- | :-------------------------------------------------------------------------------------------------------------------------- |
| Language | IDE가 활성 파일의 프로그래밍 언어를 식별할 수 없는 경우와 같이 `Unknown` 표시됩니다.                                                                      |
| 특징       | 이전 클라이언트가 채팅 모드(예 `chat_panel_unknown_mode`: )를 지정하지 않고 일반 이벤트를 보낼 때 나타납니다.                                                 |
| Model    | 이벤트에 사용된 모델을 식별하는 정보가 부족할 때 나타납니다. 비 사용자 대상 작업(예: 요약 또는 의도 탐지)에 사용될 때 일부 내부 모델(`gpt-4o-mini` 예) 이 `Unknown`와 함께 나타날 수 있습니다. |

`Unknown` 값은 대시보드 시각화에서 제외되지만 완전성을 위해 API 및 NDJSON 데이터에 표시됩니다. 사용자가 더 풍부한 원격 분석을 보내는 최신 IDE 및 확장 버전으로 업그레이드하면 데이터 양이 `Unknown` 줄어듭니다.

## 서버 측 원격 분석으로 식별된 사용자

Copilot 사용 메트릭은 클라이언트 쪽 및 서버 쪽 원격 분석을 결합하여 활성 사용자를 식별합니다. 서버 쪽 원격 분석을 통해 활성으로 확인되었지만 클라이언트 원격 분석이 수신되지 않은 사용자는 활성 사용자 합계(예: `daily_active_users`)에 포함됩니다. 가능한 경우 이러한 사용자가 `totals_by_ide` 에도 표시될 수 있습니다(사용자별 보고서에서는 여기에는 가장 최근에 감지된 IDE 및 Copilot 확장 프로그램 버전이 포함됩니다). 그러나 다른 차원 내역(`totals_by_feature`, `totals_by_language_feature`, , `totals_by_language_model``totals_by_model_feature`) 및 코드 라인 메트릭은 여전히 비어 있습니다.

즉, 최상위 활성 사용자 수는 분석 배열에 반영된 사용자의 합계보다 높을 수 있습니다. 이는 예상된 동작이며 데이터 오류를 나타내지 않습니다.