사용량 메트릭

사용량 메트릭은 어떤 서비스가 실제로 얼마나 쓰였는지 세어 보여주는 성적표다. 헬스장으로 치면 회원 카드를 찍을 때마다 기록되는 출입 횟수, 그리고 어떤 트레이너 수업에 몇 명이 들어왔는지를 정리한 표와 같다. 이 숫자가 있어야 관리자는 어떤 서비스를 더 늘리고 어떤 걸 줄일지 판단할 수 있다.

문제는 여러 서비스를 동시에 쓸 때 생긴다. 헬스장에 트레이너가 한 명뿐이면 출입 기록만 세도 되지만, 트레이너가 여러 명이 되면 '누구 수업에 몇 명이 왔는지'를 트레이너별로 나눠 세야 비교가 가능해진다. 이렇게 항목을 잘게 쪼개 집계하는 것이 사용량 메트릭을 설계할 때 중요한 부분이다.

또 하나 조심할 점은, 겉보기에 이름이 같은 숫자라도 셈하는 방식이 다르면 서로 다른 값일 수 있다는 것이다. 같은 이름의 항목이 두 곳에 있다고 무작정 더하거나 같다고 보면 실제 이용 현황을 잘못 읽게 된다.

기사는 "깃허브 코파일럿 사용량 메트릭 API가 서드파티 에이전트 앱 활동을 에이전트별로 분리해 보고하는 기능을 공개했다"고 전한다. 여기서 주의할 오해: 새로 추가된 필드의 user_initiated_interaction_count는 기존에 같은 이름으로 있던 최상위 필드와 셈하는 대상이 다르다. 이름이 같다고 두 수치를 합치거나 동일시하면 안 된다.

평소 쓰는 AI 서비스나 개발 도구의 관리자·계정 설정 화면에서 사용량 또는 청구 관련 메뉴를 찾아보라. 1) 일별·월별 이용 횟수가 어떻게 나뉘어 표시되는지 확인한다. 2) 여러 도구나 기능을 함께 쓰고 있다면 항목별로 숫자가 분리돼 있는지, 아니면 하나로 합산돼 있는지 비교해본다. 3) 이름이 비슷한 두 항목이 있다면 각각의 정의(무엇을 셀 때 카운트하는지)를 설명 문서에서 찾아 서로 다른 값인지 확인한다.