GitHub Copilot 사용량 API에 도구별 집계 추가

발행 2026.10.23출처 github.blog · Allison

Copilot usage metrics API가 이제 OpenCode와 같이 이전에는 보고서에 포함되지 않았던 도구를 포함해, 개발자들이 Copilot과 함께 사용하는 더 많은 도구의 모델 사용량을 보고합니다. 새로운 totals_by_client 배열은 enterprise, organization, enterprise-user, organization-user의 1일 및 28일 보고서에서 사용할 수 있습니다.

새로운 내용

각 totals_by_client 항목은 하나의 클라이언트를 나타내며 다음을 포함합니다:

client: opencode, claude_code, codex, zed, copilot_cli, github_app, cloud_agent, code_review, vscode, jetbrains 같은 요청을 보낸 도구입니다. 인식되지 않는 클라이언트는 other 아래로 묶입니다.
request_count: 해당 클라이언트에서 성공한 모델 요청 수입니다.
session_count: 해당 클라이언트의 고유 세션 수입니다.
token_usage: 프롬프트 토큰, 출력 토큰, 그리고 요청당 평균 토큰 수입니다.
totals_by_model: 동일한 요청 및 토큰 지표를 모델별로 나눈 값이며, 모델이 직접 요청되었는지 (user_selected), 자동으로 선택되었는지 (auto), 아니면 제품에 의해 선택되었는지 (product_selected)를 보여주는 model_selection_mode가 포함됩니다. 아직 개별적으로 보고되지 않는 선택 모드는 other로 표시되며, 정규화할 수 없는 값은 unknown으로 표시됩니다.

중요한 이유

더 많은 개발자가 IDE 밖의 도구에서 모델 제공자로 Copilot을 사용하고 있습니다. 이러한 도구는 종종 편집기 텔레메트리를 보내지 않기 때문에, 해당 사용량은 totals_by_ide에 빠져 있어 파악하기 어려웠습니다. 서버에서 요청을 집계하면 그 격차가 해소되어 어떤 도구가 Copilot 사용량을 이끄는지 확인하고, 도구별 요청 및 토큰 사용량을 비교하며, 실제 사용량을 바탕으로 도구 지원 및 거버넌스 결정을 내릴 수 있습니다.

이는 agent app activity와는 다릅니다. agent app activity는 GitHub에서 Claude와 Codex 같은 agent 앱이 시작한 작업을 집계합니다. totals_by_client는 Copilot을 사용하는 어떤 도구에서든 발생하는 모델 트래픽, 즉 요청과 토큰을 측정합니다.

중요한 참고 사항

범위: enterprise, organization, enterprise-user, organization-user 보고서의 1일 및 28일 버전 모두에 적용됩니다. 집계된 28일 보고서에서는 각 day_totals 항목에 totals_by_client가 표시됩니다.
접근 권한: enterprise 소유자와 청구 관리자, organization 소유자, 그리고 View Copilot Metrics 권한을 부여하는 organization 또는 enterprise의 사용자 지정 역할이 있는 모든 사용자가 사용할 수 있습니다. Copilot usage metrics 정책이 활성화되어 있어야 합니다.
Copilot code review 및 Copilot cloud agent: 이 클라이언트에서 온 요청은 제품이 모델을 선택하므로 product_selected로 보고됩니다. Copilot code review 모델은 unknown으로 보고됩니다.
요청 수: request_count는 프롬프트가 아니라 모델 호출 수를 셉니다. 하나의 프롬프트가 여러 모델 호출을 유발할 수 있으므로, 이 필드를 프롬프트 또는 상호작용 수와 직접 비교하지 마세요.
클라이언트 식별: 클라이언트는 각 요청과 함께 보내는 통합 ID로 식별됩니다. client는 검증된 신원이 아니라 최선의 노력으로 묶은 그룹으로 취급하세요.
하위 호환성: 이 변경은 추가적인 변화입니다. 기존 필드는 변경되지 않으며, 보고할 사용량이 없으면 totals_by_client는 빈 배열입니다.