Copilot 외부 도구 지표, 호출 수와 질문 수 구분

원문 소식, 쉽게 읽기

GitHub는 2026년 10월 23일 Copilot 사용량 보고서에 OpenCode 같은 외부 도구의 모델 이용 내역을 더 폭넓게 담는다고 발표했습니다. API는 프로그램이 보고서를 가져오는 통로이며, 새 totals_by_client 항목은 어떤 도구에서 모델 요청이 들어왔는지를 나눠 보여 줍니다. Copilot을 모델 제공자로 연결한 도구들의 이용 흐름을 살펴보는 변화입니다. 출처

기존 편집기별 집계 totals_by_ide는 도구가 보내는 편집기 사용 기록에 의존했습니다. IDE는 코드를 작성하는 개발 편집기입니다. 이런 기록을 보내지 않는 외부 도구의 이용 내역은 빠져 있었는데, GitHub는 서버에서 모델 요청을 세어 이 빈틈을 메운다고 설명했습니다. 따라서 새 항목으로 비교할 때는 관측 범위가 넓어진 점을 함께 봐야 합니다. 출처

호출·세션·작업 시작을 나눠 읽기

클라이언트는 모델에 요청을 보내는 도구를 뜻합니다. 각 클라이언트 행에는 성공한 모델 호출 수, 서로 다른 세션 수, 입력·출력 토큰과 호출당 평균 토큰이 들어갑니다. 토큰은 모델이 입력과 출력을 처리할 때 사용하는 텍스트 조각의 단위입니다. 서로 다른 종류의 횟수는 다음처럼 구분할 수 있습니다. 출처

항목	세는 대상	읽을 때의 기준
request_count	성공한 모델 호출	한 번의 질문에서 여러 호출이 생길 수 있음
session_count	해당 클라이언트의 서로 다른 세션	요청 수와 세션 수를 별도 항목으로 보기
token_usage	입력·출력 토큰과 호출당 평균	같은 기간·범위에서 모델 처리량 비교
에이전트 앱의 작업 시작 수	사람이 시작한 에이전트 앱 작업	모델 호출과 구분되는 작업 시작 이벤트

앞의 세 행은 새 클라이언트 집계, 마지막 행은 기존 에이전트 앱 지표를 설명합니다. 기존 지표의 중첩된 user_initiated_interaction_count는 작업 시작을 세며, 같은 이름의 최상위 필드는 다른 사용 기록에서 명시적으로 보낸 질문을 셉니다. GitHub도 두 필드를 더하거나 같은 값으로 취급하지 말라고 안내합니다. 출처 출처

가령 질문 한 번을 처리하면서 모델을 세 번 호출했다고 가정하면, 그 세 호출이 모두 성공한 경우 request_count에는 3이 잡힙니다. 이는 집계 단위를 설명하기 위한 가상 사례입니다. 실제 요청 하나가 몇 번의 모델 호출로 이어지는지는 이 예시가 정하지 않습니다. 출처

모델 선택·이름·조회 조건

모델별 하위 내역에는 누가 모델을 골랐는지도 표시합니다. user_selected는 직접 선택, auto는 자동 선택, product_selected는 제품의 선택입니다. 아직 따로 보고하지 않는 선택 방식은 other, 표준 값으로 맞출 수 없는 값은 unknown에 들어갑니다. Copilot 코드 검토와 cloud agent는 제품이 모델을 정하므로 product_selected로 기록되며, 코드 검토의 모델 이름은 unknown으로 나옵니다. 출처

도구 이름의 근거는 요청과 함께 전달된 연동 식별자입니다. 예를 들어 opencode, vscode, copilot_cli 같은 이름으로 묶고, 인식하지 못한 도구는 other로 합칩니다. GitHub는 이를 도구의 신원을 검증한 결과가 아니라 가능한 범위에서 분류한 값으로 설명했습니다. 이 식별 방식은 보고서 이름으로 도구를 판별할 때의 한계입니다. 출처

대상은 기업·조직 전체와 각 범위의 사용자별 1일·28일 보고서입니다. 집계형 28일 보고서에서는 날짜별 day_totals 안에 새 배열이 들어갑니다. 보고서는 매일 생성되고, 최신 28일 자료는 처리가 끝난 가장 최근 날짜까지의 기간을 다룹니다. 같은 범위와 처리 기간을 맞춰 비교할 수 있습니다. 출처 출처

조회하려면 Copilot 사용량 지표 정책이 켜져 있어야 합니다. 공식 API 문서는 기업용 엔드포인트를 쓰려면 기업의 정책을 Enabled everywhere로 설정해야 한다고 명시합니다. 기업 소유자·청구 관리자, 조직 소유자 또는 지표 보기 권한을 받은 맞춤 역할이 접근 대상입니다. 변경은 기존 필드를 유지하며 새 항목을 더하는 방식이고, 보고할 이용 내역이 없으면 totals_by_client는 빈 배열로 나옵니다. 출처 출처

OYOPICK의 시선

사용 도구가 편집기 밖으로 넓어지는 상황에서, 빠져 있던 모델 처리량을 볼 수 있게 된 변화는 조직의 지원 우선순위를 정하는 데 도움이 되겠습니다. 다만 이 자료로 확인할 수 있는 성과는 관측 범위와 처리량입니다. 도입 전후를 평가할 때는 새 집계가 포함한 경로와 같은 보고 기간을 먼저 맞추고, 실제 업무 결과는 별도로 살피는 편이 타당하다고 봅니다.

특히 도구 이름이 요청자가 보낸 식별자에 근거한다는 점을 운영 판단에 반영해야겠습니다. 지원할 도구를 찾는 단서로 활용하되, 접근 제한 같은 강한 결정을 내릴 때는 조직의 연동 설정과 함께 대조하는 편이 좋겠습니다. 앞으로 보고서가 집계 범위의 변화와 클라이언트 식별 근거를 더 명확히 보여 준다면, 사용량을 설명하는 숫자가 더 신뢰할 만한 도구 운영으로 이어질 수 있겠습니다.