>[!NOTE] Copilot 사용 지표는 현재 [데이터 보호를](https://gh.io/dpa) 사용하여 공개 미리 보기에 있으며 변경될 수 있습니다.
Copilot 사용 메트릭 대시보드, API 및 내보내기 파일은 모두 동일한 원격 분석 데이터를 활용하지만, 이를 각각 다르게 집계하고 표시합니다. 이러한 차이점을 이해하면 원본 간에 숫자를 조정하고 내부 보고서를 준비할 때 분석을 신뢰할 수 있습니다.
- Copilot 사용 메트릭 대시보드는 엔터프라이즈 및 조직 수준에서 사용할 수 있습니다.
- Copilot 사용 지표 API는 엔터프라이즈 수준, 조직 수준, 사용자 수준의 레코드를 지원합니다.
전제 조건
Copilot 사용 지표는 사용자의 IDE에서 수집된 원격 분석에 기반합니다. 개발자가 자신의 IDE에서 원격 분석을 비활성화한 경우, Copilot 활동은 대시보드, API 보고서 또는 내보낸 데이터에 포함되지 않습니다.
누락된 사용자 또는 예기치 않게 낮은 채택 수가 발견되면 다른 원인을 해결하기 전에 IDE 원격 분석 설정을 확인합니다.
메트릭 정렬
대시보드 및 API는 주요 메트릭에 공유 정의를 사용합니다.
| 개념 | 대시보드 지표 | API 또는 내보내기 필드 | 비고 |
|---|---|---|---|
| 활성 사용자 | 매일/매주/총 활성 사용자 |
`user_initiated_interaction_count` > 0 | 사용자는 해당 날 IDE에서 Copilot와 상호 작용한 경우 활성으로 간주됩니다. |
| 수락률 | 코드 완성 수락률 |
code_acceptance_activity_count ÷ code_generation_activity_count | 반올림은 다를 수 있지만 두 소스 모두 동일한 방식으로 수용률을 계산합니다. |
| 에이전트 도입 | 에이전트 채택 차트 |
totals_by_feature 기능 = "agent"인 경우 | Copilot 에이전트와 상호 작용한 사용자를 반영합니다. |
| 언어 사용 | 언어 사용 현황 차트 |
totals_by_language_feature 또는 totals_by_language_model | 대시보드는 이러한 집계된 필드를 시각화합니다. |
전체 필드 설명은 GitHub Copilot 사용 메트릭을 참조하세요.
보고서 간 불일치
대시보드 데이터, API 보고서 및 내보내기 간의 작은 차이가 예상됩니다. 이러한 변형은 일반적으로 시간 창, 범위 또는 데이터 새로 고침의 차이로 인해 발생합니다.
기간
각 데이터 원본은 데이터를 다르게 집계합니다.
| 출처 | 시간 범위 | 집계 메서드 |
|---|---|---|
| Dashboard | 28일 롤링 윈도우 | 메트릭은 원활한 변동을 위해 지난 28일 동안 지속적으로 집계됩니다. |
| API들 | Daily | 각 레코드는 사용자당 일별을 나타내며, 일일 추세 분석을 사용하도록 설정합니다. |
| NDJSON 내보내기 | Daily | BI 도구 및 장기 보고에 대한 API 출력을 미러링합니다. |
보고 기간을 대시보드의 28일 기간에 맞추면 일관된 비교가 가능합니다.
지연된 원격 분석
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` 줄어듭니다.