GitHub Copilot 사용량 지표 API가 BYOK와 기업 맞춤 모델을 따로 집계: 로컬 BYOK는 하한값이며 모델별 구분 없음; 이전 보고 날짜에는 is_custom_enterprise_model 표시가 소급되지 않음

2026년 11월 3일 GitHub 변경 로그는 Copilot 사용량 지표 API가 이제 BYOK(자체 키 사용) 사용량을 따로 보여 준다고 발표했습니다. 관리자는 이를 Copilot이 호스팅하는 모델의 사용량과 구분할 수 있습니다. 지금까지는 로컬 모델과 사용자 정의 모델의 이름이 Copilot 모델과 같은 경우가 많아 BYOK 사용량이 호스팅 합계에 섞여 있었습니다. 이번 업데이트는 BYOK를 두 종류로 나눕니다. 개발자가 자기 클라이언트에서 설정하는 로컬 BYOK와, 관리자가 GitHub 설정에서 구성하는 기업 맞춤 모델입니다. 둘 다 기업과 조직 보고서에 사용자 단위와 집계 단위로, 1일과 28일 보고서 모두에 나타납니다.

로컬 BYOK는 개발자 자신의 공급자 키와 Ollama, Foundry Local, LM Studio, llama-server 같은 도구로 제공하는 로컬 모델을 가리킵니다. 요청은 Copilot CLI나 GitHub Copilot 앱에서 GitHub를 거치지 않고 개발자의 공급자 키나 로컬 모델로 직접 갑니다. 필드는 사용자 단위 보고서의 used_local_byok(그날 Copilot CLI나 Copilot 앱에서 로컬 BYOK 요청을 한 번이라도 했는지), byok_kind(local_managed, local_user, local_auto, remote_user)와 surface(copilot_cli, copilot_app)별로 세션, 요청, 프롬프트, 토큰 수를 주는 totals_by_local_byok, 집계 보고서의 일간·주간·월간 활성 로컬 BYOK 사용자 수입니다.

기업 맞춤 모델은 관리자가 GitHub 설정에서 구성하며 요청은 GitHub를 거쳐 공급자로 갑니다. 새 is_custom_enterprise_model은 totals_by_client의 각 모델 항목에 붙는 불리언 값으로, 기업이나 조직에 구성된 맞춤 모델을 쓴 요청이면 true입니다. GitHub가 서버 측에서 이 요청을 관측하므로 IDE를 포함한 모든 클라이언트를 포괄합니다. 한 모델이 Copilot 호스팅과 맞춤 모델로 모두 쓰이면 두 항목으로 나타나 수치가 섞이지 않고, 맞춤 모델 항목에는 실제 요청 수와 토큰 수가 들어갑니다.

이는 거버넌스와 비용 분석에 도움이 됩니다. 관리자는 누가 자기 공급자 키, 로컬 모델, 기업 맞춤 모델로 요청을 보내는지 BYOK 정책과 대조해 볼 수 있습니다. Copilot 호스팅 사용량과 자기 공급자가 청구하거나 무료 로컬 모델에서 도는 사용량을 나눠, 사용자당 비용이 Copilot이 실제로 제공한 부분만 반영하게 할 수 있습니다. 여러 도구에 걸친 사용량을 한 화면에서 보고, BYOK나 맞춤 모델 사용자를 기존 Copilot 지표와 비교할 수도 있습니다. 다만 이 필드들은 세션, 요청, 프롬프트, 토큰의 개수이며 글은 금액 필드를 설명하지 않으므로 청구서가 아닙니다.

“중요 사항”에는 몇 가지 제약이 있습니다. 첫째, 기존 합계는 바뀌지 않습니다. BYOK 사용량은 이미 집계되고 있었고 로컬 BYOK는 totals_by_cli와 totals_by_copilot_app의 부분집합이며 맞춤 모델 사용량은 이미 totals_by_client에 있습니다. 둘째, 로컬 BYOK는 하한값입니다. 이 필드는 클라이언트 텔레메트리에 의존해 텔레메트리를 끄면 적게 잡히고, 일부 로컬 공급자는 토큰 사용량을 보고하지 않아 토큰 수도 적게 나올 수 있습니다. 기업 맞춤 모델은 서버 측에서 관측하므로 이 제한이 없습니다. 셋째, 모델 이름은 기존 정규화를 따르며 인식되지 않는 이름은 unknown으로 나오고, 로컬 BYOK는 모델 이름별로 나뉘지 않습니다. 넷째, 소급 적용이 없어 릴리스 이전 날짜의 보고서에는 is_custom_enterprise_model이 없고, 그 이전 날짜에 로컬 BYOK 필드가 있는지는 글에 나와 있지 않습니다. 다섯째, 기업 소유자, 기업 청구 관리자, 조직 소유자, View Copilot Metrics 권한이 있는 사용자 정의 역할 보유자만 쓸 수 있고 Copilot 사용량 지표 정책이 켜져 있어야 합니다.

“부분집합”이라는 규칙의 실무적 결과는 이중 집계입니다. 로컬 BYOK는 이미 totals_by_cli와 totals_by_copilot_app 안에 있고 맞춤 모델 사용량은 이미 totals_by_client 안에 있으므로, 새 필드를 기존 합계에 더하는 대시보드는 같은 요청을 두 번 세게 됩니다. 새 필드는 빼거나 걸러 내기 위한 조각이지 더할 추가 행이 아닙니다. 두 종류는 신뢰도도 다릅니다. 맞춤 모델의 수치는 GitHub가 서버 측에서 관측하지만 로컬 BYOK 수치는 개발자나 정책이 끌 수 있는 클라이언트 텔레메트리에서 오므로, 로컬 BYOK 선이 내려갔을 때 사용이 줄었는지 텔레메트리가 줄었는지는 보고서만으로 구분할 수 없습니다.

근거로 삼은 REST 문서는 엔드포인트를 더 구체적으로 설명합니다. 보고서는 유효 기간이 있는 서명된 다운로드 링크로 받는 NDJSON 파일입니다. 기업 엔드포인트는 기업 전체에서 “Copilot usage metrics” 정책이 Enabled everywhere여야 합니다. 세분화된 권한은 기업용이 “View Enterprise Copilot Metrics”, 조직용이 “View Organization Copilot Metrics”이며 기록은 2025년 10월 10일부터 최대 1년까지 거슬러 올라갑니다. 이 REST 페이지는 이번에 추가된 BYOK 필드를 직접 정의하지 않으며, 확보한 자료 중 이를 설명하는 곳은 변경 로그뿐이고 그 권한 이름 “View Copilot Metrics”는 문서의 두 이름과 정확히 일치하지 않습니다. 글에 대응 관계가 없으므로 접근 권한을 설정하기 전에 본인의 GitHub 설정에서 확인하세요.