사용 메트릭 대시보드, API 및 내보내기 파일은 Copilot 모두 동일한 기본 원격 분석 데이터를 사용하지만 집계하고 다르게 표시합니다. 이러한 차이점을 이해하면 원본 간에 숫자를 조정하고 내부 보고서를 준비할 때 분석을 신뢰할 수 있습니다.
- Copilot 사용 메트릭 대시보드는 엔터프라이즈 및 조직 수준에서 사용할 수 있습니다.
- 사용 메트릭 API는 Copilot엔터프라이즈, 조직 및 사용자 수준 레코드를 지원합니다.
- 팀 수준 합계는 미리 집계되지 않습니다. 사용자별 사용 메트릭 보고서와 사용자 팀 보고서를 조인하여 생성됩니다. 팀 수준의 Copilot 사용 지표을(를) 참조하세요.
전제 조건
IDE 기반 Copilot 사용 메트릭은 사용자의 IDE에서 원격 분석에 따라 달라집니다. 개발자가 IDE에서 원격 분석을 사용하지 않도록 설정한 경우 IDE별, 기능별 및 코드 줄 분석과 같은 자세한 IDE 기반 Copilot 작업은 대시보드, API 보고서 또는 내보낸 데이터에 표시되지 않습니다 . 그러나 클라이언트 원격 분석을 사용할 수 없는 경우에도 서버 쪽 원격 분석은 활성 사용자 수에서 이러한 사용자를 표시할 수 있습니다.
누락된 사용자 또는 예기치 않게 낮은 채택 수가 발견되면 다른 원인을 해결하기 전에 IDE 원격 분석 설정을 확인합니다.
코파일럿 CLI 메트릭(daily_active_cli_users 및 totals_by_cli)은 IDE 원격 분석과 별도로 수집 및 보고됩니다. CLI 사용은 IDE 기반 활성 사용자 수 또는 기타 IDE 메트릭에 영향을 주지 않습니다.
메트릭 정렬
대시보드 및 API는 주요 메트릭에 공유 정의를 사용합니다.
| 개념 | 대시보드 지표 | API 또는 내보내기 필드 | 비고 |
|---|---|---|---|
| 활성 사용자 | 매일/매주/총 활성 사용자 | ||
user_initiated_ > 0 | 사용자는 해당 일에 IDE에서 Copilot와 상호 작용한 경우 활성 사용자로 간주됩니다. | ||
| 수락률 | 코드 완성 수락률 | ||
code_acceptance_ ÷ code_generation_ | 반올림은 다를 수 있지만 두 소스 모두 동일한 방식으로 수용률을 계산합니다. | ||
| 에이전트 도입 | 에이전트 채택 차트 | ||
totals_by_feature 기능 = "agent"인 경우 | |||
| 코파일럿 에이전트와 상호 작용한 사용자를 반영합니다. | |||
| 언어 사용 | 언어 사용 현황 차트 | ||
totals_by_language_ 또는 totals_by_language_ | 대시보드는 이러한 집계된 필드를 시각화합니다. |
전체 필드 설명은 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_: )를 지정하지 않고 일반 이벤트를 보낼 때 나타납니다. |
| Model | 이벤트에 사용된 모델을 식별하는 정보가 부족할 때 나타납니다. 비 사용자 대상 작업(예: 요약 또는 의도 탐지)에 사용될 때 일부 내부 모델(gpt-4o-mini 예) 이 Unknown와 함께 나타날 수 있습니다. |
Unknown 값은 대시보드 시각화에서 제외되지만 완전성을 위해 API 및 NDJSON 데이터에 표시됩니다. 사용자가 더 풍부한 원격 분석을 보내는 최신 IDE 및 확장 버전으로 업그레이드하면 데이터 양이 Unknown 줄어듭니다.
서버 측 원격 분석으로 식별된 사용자
Copilot 사용 메트릭은 클라이언트 쪽 및 서버 쪽 원격 분석을 결합하여 활성 사용자를 식별합니다. 서버 쪽 원격 분석을 통해 활성으로 확인되었지만 클라이언트 원격 분석이 수신되지 않은 사용자는 활성 사용자 합계(예: daily_active_users)에 포함됩니다. 그러나 해당 차원 분석(totals_by_ide, , totals_by_feature, totals_by_language_feature``totals_by_language_model,totals_by_model_feature) 및 코드 줄 메트릭은 비어 있습니다.
즉, 최상위 활성 사용자 수는 분석 배열에 반영된 사용자의 합계보다 높을 수 있습니다. 이는 예상된 동작이며 데이터 오류를 나타내지 않습니다.