사용 메트릭 대시보드, API 및 내보내기 파일은 Copilot 모두 동일한 기본 원격 분석 데이터를 사용하지만 집계하고 다르게 표시합니다. 이러한 차이점을 이해하면 원본 간에 숫자를 조정하고 내부 보고서를 준비할 때 분석을 신뢰할 수 있습니다.
- Copilot 사용 메트릭 대시보드는 엔터프라이즈 및 조직 수준에서 사용할 수 있습니다.
- 사용 메트릭 API는 Copilot엔터프라이즈, 조직, 리포지토리 및 사용자 수준 레코드를 지원합니다.
- 팀 수준 합계는 미리 집계되지 않습니다. 사용자별 사용 메트릭 보고서와 사용자 팀 보고서를 조인하여 생성됩니다. 팀 수준의 Copilot 사용 지표을(를) 참조하세요.
- 리포지토리 수준 보고서는 요청된 날짜에 활동이 있는 리포지토리에 대한 일일 끌어오기 요청 작업을 제공합니다. Copilot 사용 메트릭에서 사용할 수 있는 데이터을(를) 참조하세요.
전제 조건
IDE 기반 Copilot 사용 메트릭은 사용자의 IDE에서 원격 분석에 따라 달라집니다. 개발자가 IDE에서 원격 분석을 사용하지 않도록 설정한 경우 IDE별, 기능별 및 코드 줄 분석과 같은 자세한 IDE 기반 Copilot 작업은 대시보드, API 보고서 또는 내보낸 데이터에 표시되지 않습니다 . 그러나 클라이언트 원격 분석을 사용할 수 없는 경우에도 서버 쪽 원격 분석은 활성 사용자 수에서 이러한 사용자를 표시할 수 있습니다.
누락된 사용자 또는 예기치 않게 낮은 채택 수가 발견되면 다른 원인을 해결하기 전에 IDE 원격 분석 설정을 확인합니다. 지원되는 IDE 및 확장 버전은 Coverage and requirements for Copilot usage metrics을 참조하세요.
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와 조정하지 마세요.
조직 귀속
조직 수준 Copilot 사용 메트릭은 개별 작업이 발생하는 위치가 아니라 조직 멤버 자격을 기반으로 합니다. 기업의 메트릭에 표시하려면 사용자에게 해당 엔터프라이즈 내에 할당된 활성 Copilot 시트가 있어야 합니다.
사용자가 기업에서 좌석이 있으면 해당 사용량은 좌석이 할당된 위치에 관계없이 사용자가 속한 해당 기업 내의 모든 조직에 귀속됩니다. 다음은 그 예입니다.
- 관리 목적으로 전용 조직에 라이선스가 할당된 경우 사용자는 속한 엔터프라이즈의 다른 조직에 대한 메트릭에 계속 표시됩니다.
- 사용자가 기업 외부의 별도 조직에 자리가 Copilot 있는 경우에도 해당 활동은 기업 내에서 하나 이상의 좌석이 있는 한 기업의 조직 수준 메트릭에 계속 포함됩니다.
단일 사용자의 사용량은 여러 조직 대시보드에 표시될 수 있지만 해당 사용자는 엔터프라이즈 수준 합계에서 한 번만 계산됩니다. 엔터프라이즈 합계를 계산하기 위해 조직 수준 합계를 추가하지 마세요.
조직 수준 보고서는 2025년 12월 12일부터 사용할 수 있습니다.
끌어오기 요청 수명 주기 메트릭의 범위 간 해석
끌어오기 요청 수명 주기 메트릭은 조직 및 엔터프라이즈 수준에서 모두 사용할 수 있습니다. 보고서를 비교할 때 다음 사항에 유의하세요.
- 중복 제거: 엔터프라이즈 수준 보고서는 조직 전체에서 사용자를 중복 제거합니다. 조직 수준 보고서는 그렇지 않습니다.
- 끌어오기 요청 전용 데이터: 끌어오기 요청 데이터는 리포지토리 작업에서 파생되므로 IDE 사용 메트릭이 없는 경우에도 끌어오기 요청 수명 주기 메트릭이 나타날 수 있습니다.
- 속성 지정 시점: 소유자 간에 리포지토리 또는 조직이 전송되는 경우, 끌어오기 요청 만들기, 검토 및 병합 이벤트는 각 이벤트가 발생한 시기에 따라 다른 주체로 귀속될 수 있습니다.
메트릭 정렬
대시보드 및 API는 주요 메트릭에 공유 정의를 사용합니다.
| 개념 | 대시보드 지표 | API 또는 내보내기 필드 | 비고 |
|---|---|---|---|
| 활성 사용자 | 매일/매주/총 활성 사용자 | ||
user_initiated_ > 0 | 사용자는 해당 일에 IDE에서 Copilot와 상호 작용한 경우 활성 사용자로 간주됩니다. | ||
| 수락률 | 코드 완성 수락률 | ||
code_acceptance_ ÷ code_generation_ | 반올림은 다를 수 있지만 두 소스 모두 동일한 방식으로 수용률을 계산합니다. | ||
| 에이전트 도입 | 에이전트 채택 차트 | ||
totals_by_feature 기능 = "agent"인 경우 | |||
| Copilot agent와 상호 작용한 사용자를 반영합니다. | |||
| 언어 사용 | 언어 사용 현황 차트 | ||
totals_by_language_ 또는 totals_by_language_ | 대시보드는 이러한 집계된 필드를 시각화합니다. | ||
| 채택 집단/단계 | 도입 코호트 분포(영향 대시보드) | ||
ai_adoption_phase, totals_by_ai_ | 단계 정의는 공유됩니다. 대시보드는 후행 28일 모집단을 사용합니다. | ||
total_engaged_ 내에서 totals_by_ai_는 레코드의 특정 날짜에 활성 상태인 사용자 수를 집계하고, users_in_phase_는 해당 날짜 기준의 전체 롤링 28일 단계 모집단을 포함합니다. 일일 수를 대시보드의 롤링 모집단과 직접 비교하지 마세요. 대시보드에 "채팅 우선 사용자"로 표시된 사용자는 API 값 No Cohort에 해당합니다. |
전체 필드 설명은 GitHub Copilot 사용 메트릭을 참조하세요.
보고서 간 불일치
대시보드 데이터, API 보고서 및 내보내기 간의 작은 차이가 예상됩니다. 이러한 변형은 일반적으로 시간 창, 범위 또는 데이터 새로 고침의 차이로 인해 발생합니다.
기간
각 데이터 원본은 데이터를 다르게 집계합니다.
| 출처 | 시간 범위 | 집계 메서드 |
|---|---|---|
| Dashboard | 28일 롤링 윈도우 | 메트릭은 원활한 변동을 위해 지난 28일 동안 지속적으로 집계됩니다. |
| API들 | Daily | 각 레코드는 사용자당 일별을 나타내며, 일일 추세 분석을 사용하도록 설정합니다. |
| NDJSON 내보내기 | Daily | BI 도구 및 장기 보고에 대한 API 출력을 미러링합니다. |
보고 기간을 대시보드의 28일 기간에 맞추면 대부분의 비교가 더 일관됩니다. 채택 코호트의 경우 일별 total_engaged_users 수를 롤링 users_in_phase_28d 모집단과 구분합니다. 롤링 모집단을 비교할 때 스냅샷 날짜 및 범위를 맞춥니다. 동일한 사용자가 여러 날에 활성 상태일 수 있으므로 일별 활성 사용자 수를 추가하여 고유한 28일 모집단을 계산하지 마세요.
지연된 원격 분석
IDE 원격 분석은 비동기적으로 처리되므로 최근 일의 데이터가 불완전하거나 누락된 것처럼 보일 수 있습니다. 지정된 날짜에 대한 데이터는 해당 날짜가 종료된 후 UTC 기준 완전한 2일 이내에 사용할 수 있습니다. 최근 일일 메트릭의 명백한 하락은 텔레메트리가 처리되면 종종 해결됩니다.
내보내기 타이밍
NDJSON 파일은 내보내기 시 사용할 수 있는 데이터를 반영합니다. 새 원격 분석이 처리되기 전에 파일을 다운로드하는 경우 데이터가 대시보드 또는 API보다 뒤쳐질 수 있습니다. 내보내기에 2일 전체 UTC 처리 기간 내에 있는 날짜가 포함된 경우 해당 기간이 끝난 후 데이터를 다시 내보냅니다.
Unknown 값
일부 API 또는 내보내기 분석에서 "값 Unknown"은 IDE 클라이언트의 테레메트리가 활동을 범주화하기에 충분한 세부 정보를 제공하지 않을 때 나타납니다. 이 동작은 예상된 동작이며 누락된 데이터를 나타내지 않습니다.
| 분석 | Explanation |
|---|---|
| Language | IDE가 활성 파일의 프로그래밍 언어를 식별할 수 없는 경우와 같이 Unknown 표시됩니다. |
| 특징 | 이전 클라이언트가 채팅 모드(예 chat_panel_unknown_: )를 지정하지 않고 일반 이벤트를 보낼 때 나타납니다. |
| Model | 이벤트에 사용된 모델을 식별하는 정보가 부족할 때 나타납니다. 비 사용자 대상 작업(예: 요약 또는 의도 탐지)에 사용될 때 일부 내부 모델(gpt-4o-mini 예) 이 Unknown와 함께 나타날 수 있습니다. |
모델 분석에는 개발자가 직접 선택하지 않은 모델이 포함될 수 있습니다. 예를 들어, Copilot는 자동 모델 선택 또는 백그라운드 작업을 위해 다른 모델을 사용할 수 있습니다.
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) 및 코드 라인 메트릭은 여전히 비어 있습니다.
즉, 최상위 활성 사용자 수는 분석 배열에 반영된 사용자의 합계보다 높을 수 있습니다. 이는 예상된 동작이며 데이터 오류를 나타내지 않습니다.
누락된 사용량 데이터 문제 해결
자세한 분석은 IDE 또는 Copilot CLI.의 클라이언트 쪽 원격 분석에 따라 달라집니다. 이 원격 분석은 기능, 언어, 모델, 수락된 제안 및 코드 줄에 대한 데이터를 제공합니다. 서버 쪽 원격 분석은 사용자가 활성 상태임을 표시할 수 있지만 편집기에서 발생하는 일을 관찰할 수는 없습니다.
간격을 조사하기 전에 처리를 위해 활동일이 종료된 후 UTC 기준으로 꼬박 이틀을 기다립니다. 클라이언트 쪽 원격 분석이 여전히 누락된 경우 서버 쪽 데이터에 활동이 표시되더라도 보고서에 더 낮은 숫자 또는 빈 분석이 포함될 수 있습니다. 주요 원인은 다음과 같습니다.
| Cause | 보고서에 미치는 영향 | 검사할 수 있는 항목 |
|---|---|---|
IDE에서 원격 분석이 꺼져 있습니다. 예를 들어 telemetry.telemetry의 VS Code 설정으로 꺼질 수 있습니다. | IDE는 자세한 활동을 보내지 않습니다. 사용자는 여전히 서버 쪽 원격 분석을 통해 활성으로 계산될 수 있지만 기능, 언어 및 코드 줄 수 세부 내역은 비어 있습니다. | 개발자가 IDE 원격 분석을 사용하도록 설정되어 있는지 확인합니다. |
| 네트워크 프록시, 방화벽 또는 VPN은 Copilot 원격 분석 엔드포인트를 차단합니다. | 원격 분석이 꺼져 있는 경우와 동일합니다. | |
| Copilot 클라이언트 원격 분석 엔드포인트를 허용합니다. | ||
| Copilot 허용 목록 참조을(를) 참조하세요. | ||
| 클라이언트는 지원되는 IDE가 아니며 Copilot 원격 분석을 보내지 않습니다. | 사용자는 서버 쪽 원격 분석을 통해 활성으로 계산될 수 있지만 클라이언트는 totals_by_ide 또는 자세한 분석 내역에 표시되지 않습니다. | 전체 메트릭을 보려면 지원되는 IDE를 사용하세요. |
위의 원인을 확인한 후에도 간격이 지속되면 GitHub 지원 포털에 문의하고 영향을 받는 사용자, IDE, 버전 및 날짜를 포함하세요.