Michael Johnson개발자가 외부 도구를 통해 Copilot을 사용하면 일반적인 IDE 통계만으로는 요청이 어디서 왔는지 알기 어려울 수 있습니다. 2026년 10월 23일 GitHub는 Copilot usage metrics API에 totals_by_client 필드를 추가했습니다. 이 필드는 OpenCode, Claude Code, Codex, Zed를 포함한 클라이언트별로 모델 사용량을 집계합니다. 관리자는 이를 통해 편집기 밖에서 발생한 활동의 일부를 파악하고, 조직 내부의 AI 사용 규칙을 더 정확하게 논의할 수 있습니다.
새로운 보고서 세부 항목
totals_by_client의 각 항목에는 클라이언트, 성공한 모델 호출 횟수, 세션 수, prompt 및 output 토큰 수와 호출당 평균 토큰 수가 표시됩니다. 중첩된 totals_by_model은 이 지표를 모델별로 나누고, 사용자가 모델을 직접 선택했는지, 자동 선택이 적용됐는지, 제품이 모델을 지정했는지도 보여줍니다.
이 필드는 기업, 조직 및 해당 계층의 사용자별 세부 항목을 포함하는 1일 및 28일 보고서에 추가됐습니다. 집계된 28일 보고서에서는 날짜별로 클라이언트 세부 정보가 제공됩니다. 이번 변경은 기존 필드를 유지하는 추가적 변경이며, 데이터가 없으면 배열은 비어 있습니다. 자세한 내용은 GitHub의 새 usage metrics 세부 항목 발표를 참조하세요.
데이터로 파악할 수 있는 것
팀은 여러 도구를 통해 발생한 요청량과 토큰 사용량을 비교하고, 어떤 통합 기능을 지원하거나 기업 규칙에 포함할지 결정할 수 있습니다. 예를 들어 보고서에서 OpenCode의 비중이 늘었다면 개발자들이 IDE 밖에서 Copilot을 모델 제공자로 사용하고 있음을 시사할 수 있습니다. 클라이언트와 모델을 함께 비교하면 실제로 어떤 모델이 주요 부하를 발생시키는지도 확인할 수 있습니다.
예산 분석은 토큰 수와 호출 횟수부터 살펴본 다음, 현재 요금 조건과 대조하는 것이 유용합니다. request_count는 사용자 프롬프트가 아니라 모델 호출을 집계합니다. 프롬프트 하나가 여러 호출을 발생시킬 수 있으므로, 이 필드는 모델 서비스의 부하 분석에는 적합하지만 개발자의 상호작용 횟수를 직접 세는 용도에는 적합하지 않습니다.
업무 흐름에 지표를 적용하는 방법
- 접근 권한을 확인하세요. Copilot usage metrics 정책을 활성화해야 합니다. 권한을 부여받은 기업 또는 조직 소유자, 청구 관리자, 해당 지표를 볼 수 있는 권한이 있는 역할이 보고서를 조회할 수 있습니다.
- 같은 기간끼리 비교하세요. 도구를 활성화한 뒤 변경 사항을 확인하려면 1일 보고서를, 지속적인 활동 분포를 보려면 28일 보고서를 사용하세요. 각 보고서에서 호출, 토큰, 세션을 구분해 살펴보세요. 서로 다른 부하 측정 항목입니다.
- 검토 기준을 정하세요. 예를 들어 클라이언트의 토큰 또는 호출 비중이 직전 기간에 비해 크게 늘어나면 검토 대상으로 표시할 수 있습니다. 기준은 자체 요구사항과 기본 부하에 맞춰 정하세요. GitHub는 보편적인 기준값을 제시하지 않습니다.
- 보고서를 접근 설정과 대조하세요. 새로운 세부 정보는 도구의 지원 및 관리 방안을 논의할 때 참고 자료로 활용할 수 있습니다. 보고서는 기록된 사용량을 설명할 뿐, 권한 확인이나 통합 기능 목록 점검을 대신하지는 않습니다.
공식 Copilot usage metrics API 문서에는 보고서, 권한 요건, 이용 가능한 세부 항목이 설명되어 있습니다. 자동화하기 전에 해당 문서에서 필요한 보고서의 최신 스키마를 확인하고 적절한 접근 권한을 사용하세요.
클라이언트 라벨의 의미
GitHub는 도구가 요청과 함께 전달하는 integration ID를 기준으로 클라이언트를 식별합니다. 회사는 이 그룹화를 대략적인 식별 방식으로 설명합니다. 값은 트래픽을 집계하는 데 도움이 되지만, 그 자체로 사용자의 신원이나 애플리케이션의 진위를 입증하지는 않습니다. 알 수 없는 클라이언트는 other 그룹에 포함되며, 정규화할 수 없는 값은 unknown으로 표시될 수 있습니다.
별도의 특수 사례도 있습니다. Copilot code review와 Copilot cloud agent의 호출은 제품이 모델을 선택하므로 선택 모드가 product_selected로 표시됩니다. code review의 경우 모델이 unknown으로 표시될 수 있습니다. 도구 간 모델별 세부 항목을 비교할 때 이 점을 고려해야 합니다.
요약하면, totals_by_client는 외부 도구에서 발생한 Copilot 서버 호출을 집계하지 못했던 공백을 메우고, 관리자에게 부하 분석과 지원 여부 결정에 필요한 새로운 데이터를 제공합니다. 이 세부 정보를 신뢰할 수 있는 사용 현황으로 전환하려면 권한 설정 및 다른 내부 자료와 대조하고, 클라이언트 이름은 입증된 신원이 아닌 트래픽 분류로 해석해야 합니다.