Copilot 사용량 메트릭 API, 클라이언트 텔레메트리 누락과 IDE·확장 버전 미달 사용자 표시
Usage metrics API flags telemetry and version gaps
GitHub Copilot 사용량 메트릭 API가 클라이언트 텔레메트리가 수신되지 않은 사용자와 IDE 또는 확장 버전이 최소 요구치 미만인 사용자를 표시하도록 바뀌었다. 엔터프라이즈 및 조직의 사용자 리포트와 일별 리포트에 새 필드와 집계 수치가 추가됐다. 새 사용자 단위 필드는 client_telemetry_present와 usage_metrics_requirements다. client_telemetry_present가 false이면 Copilot이 사용자의 활동은 확인했지만 해당 에디터에서 사용량 이벤트가 도착하지 않았다는 뜻이다. usage_metrics_requirements는 사용자가 쓰는 각 IDE와 Copilot 확장을 최소 지원 버전 대비 met, unmet, unknown으로 구분해 보여준다. 일별 집계 필드로는 missing_client_telemetry_user_count와 below_usage_metrics_minimum_user_count가 제공된다. 두 값은 하루 단위 집계이며, 한 사용자가 두 항목에 동시에 포함될 수 있으므로 합산하지 않아야 하고 여러 날짜의 값을 더해 고유 사용자 수를 구해서도 안 된다. 값이 null이거나 생략되면 데이터가 없다는 뜻이며 false나 0이 아니다. 이번 릴리스 이전 날짜에는 값이 없다. 접근 권한은 엔터프라이즈 소유자, 엔터프라이즈 빌링 관리자, 조직 소유자, 그리고 View Copilot Metrics 권한이 있는 커스텀 역할 사용자에게 주어진다. 이 기능을 쓰려면 Copilot 사용량 메트릭 정책이 활성화되어 있어야 한다. 사용자 필드는 1일 및 28일 사용자 리포트에, 집계 수치는 1일 리포트와 28일 리포트의 day_totals 항목에 나타난다.
usage_metrics_requirements와 missing_client_telemetry_user_count 필드로 오래된 에디터나 확장, 비활성화된 IDE 텔레메트리, 프록시·방화벽으로 차단된 이벤트를 식별해 해당 사용자에게 직접 후속 조치를 할 수 있다.
원문 출처
GitHub Changelog