OpenCode에서 쓴 Copilot도 집계된다, 요청 수를 읽는 법

세 줄 요약

GitHub는 10월 23일 Copilot 사용량 API에 클라이언트별 모델 트래픽 집계를 추가했다.
OpenCode 등에서 Copilot을 통해 호출한 양을 볼 수 있으며, 다른 공급자를 쓴 호출까지 포함하는 것은 아니다.
보고서를 비교할 때는 도구 이름뿐 아니라 요청의 단위, 보고 기간, 조직 범위를 맞춰야 한다.

IDE 보고서의 빈칸이 곧 미사용은 아니다

OpenCode 같은 도구가 Copilot을 모델 공급자로 사용해도 IDE 활동 보고서에서는 그 사용량을 파악하기 어려웠다. 편집기 원격 측정 데이터를 보내지 않는 도구가 있기 때문이다. 새 totals_by_client는 서버의 모델 요청을 집계해 이 빈칸을 줄인다. GitHub의 10월 23일 발표는 도구별 요청·토큰 사용량을 확인하는 기능으로 설명한다.

요청 수는 사용자가 입력한 문장 수가 아니다

request_count는 성공한 모델 호출을 센다. 한 번의 사용자 입력이 여러 호출로 이어질 수 있다. GitHub에서 에이전트 앱이 시작한 작업 수와도 다른 단위다.

필드	읽는 기준
`client`	요청을 보낸 도구의 분류다. 검증된 신원 정보는 아니다.
`request_count`	성공한 모델 호출 수다.
`session_count`	구분되는 세션 수다.
`token_usage`	입력·출력 토큰과 요청당 평균을 담는다.
`totals_by_model`	모델별 호출·토큰과 모델 선택 방식을 나눈다.

클라이언트 식별은 요청에 담긴 integration ID에 의존한다. 따라서 도구별 분류를 확정적인 앱 신원 증명으로 사용하면 안 된다. 28일 집계 보고서에서는 각 day_totals 안에 새 배열이 들어간다.

API 응답의 링크에서 보고서를 받는다

사용량 API를 호출한 응답이 곧 모든 지표를 담은 보고서 본문은 아니다. 공식 REST 문서의 조직용 28일 엔드포인트는 다운로드 링크와 집계 시작·종료 날짜를 반환한다.

GET /orgs/ORG/copilot/metrics/reports/organization-28-day/latest

ORG에는 조직 이름이 들어간다. 응답의 download_links에서 보고서 파일을 받고, report_start_day와 report_end_day로 범위를 확인한 뒤 내용을 읽는다. 다운로드 링크는 유효기간이 있는 서명 URL이다. 같은 링크를 영구적인 데이터 주소로 취급하지 않아야 한다.

조회에는 Copilot 사용량 정책 활성화와 해당 범위의 보기 권한이 필요하다. 조직 소유자나 사용량 보기 권한을 받은 역할 등이 대상이다. 조직용 엔드포인트에서 OAuth 앱 토큰 또는 classic PAT를 사용할 때는 read:org 범위도 요구된다. 개인 Copilot을 쓴다는 사실만으로 조직 보고서를 읽을 수 있는 것은 아니다.

도구별 사용량과 조직 성과를 구분한다

같은 날짜처럼 보여도 일별 파일과 28일 대시보드는 집계 범위가 다를 수 있다. GitHub의 지표 대조 문서는 기간·범위·데이터 갱신 시점이 차이를 만드는 요인이라고 설명한다. 최근 날짜의 값이나 먼저 내려받은 파일을 확정된 전체 사용량으로 간주하면 감소를 잘못 해석할 수 있다.

조직을 합치는 방법도 중요하다. 사용자가 여러 조직에 속하면 각 조직 보고서에 나타날 수 있지만, 엔터프라이즈 합계에서는 중복이 제거된다. 조직별 사용자 수를 단순히 더해 엔터프라이즈의 고유 사용자 수로 쓰면 안 된다. 좌석 할당 정보 역시 사용량 보고서와 별도의 관리 API에서 확인한다. Copilot 지표 개념 문서가 이 구분을 명시한다.

운영 보고서에서는 먼저 같은 기간의 도구별 호출·토큰 사용을 비교하는 편이 맞다. 개발 속도가 달라졌는지는 PR 병합 수나 병합까지 걸린 시간처럼 결과를 나타내는 지표와 함께 판단해야 한다. 모델을 더 많이 호출했다는 사실만으로 일이 더 잘 끝났다고 결론낼 수는 없다.

자주 묻는 질문

OpenCode의 모든 모델 사용량이 잡히는가?

아니다. 이번 변경은 Copilot을 통해 발생한 모델 트래픽이 대상이다.

조직별 사용자 수를 더하면 엔터프라이즈 합계가 되는가?

아니다. 여러 조직에 속한 사용자가 중복될 수 있다. 비교하는 보고서의 범위를 먼저 맞춰야 한다.

API 결과를 받았는데 사용량 배열이 바로 보이지 않는 이유는 무엇인가?

보고서 엔드포인트는 다운로드 링크를 반환한다. 해당 파일과 보고 날짜를 확인해야 한다.