클라우드플레어가 셀프서브(self-serve) 계정을 위한 '빌러블 유세지 API(Billable Usage API)'를 공개했다. 계정에서 발생하는 사용량과 비용을 하나의 엔드포인트로 조회할 수 있게 한 것이 핵심이다. 워커스(Workers), R2, D1, 워커스 AI, 벡터라이즈(Vectorize), 이미지(Images), 스트림(Stream)처럼 사용량 기반으로 과금되는 제품 전반을 한 번의 호출로 제품별·과금 기간별로 나눠 돌려준다. 응답은 HTTP 200에 application/json 형식이며, 클라우드플레어 표준 API 봉투 구조를 따라 result 배열 안에 '제품 하나의 한 과금 기간'을 한 행으로 담는다. 현재 데이터는 하루 단위로 갱신되며, 회사는 향후 더 실시간에 가까운 제공을 목표로 한다고 밝혔다.
대시보드가 답이 아닌 순간
이번 발표가 나온 배경에는 '에이전트'라는 흐름이 있다. 코드를 작성하고, 워커를 배포하고, 인프라를 대신 프로비저닝하는 프로그램이 계정 안에서 실제로 돈을 쓰기 시작하면, 사람이 보기 좋은 대시보드만으로는 부족해진다. 프로그램이 지출한 내용을 다시 프로그램이 소비할 수 있는 형태로, 그것도 월말이 아니라 하루 중 수시로 제품 단위로 확인해야 한다는 것이 클라우드플레어의 문제의식이다. 대시보드는 사람을 위한 정답이지만 자동화를 위한 정답은 아니라는 표현이 이 API의 존재 이유를 압축한다.
실무적으로 이 지점은 낯설지 않다. 재무팀은 지출을 자체 시스템으로 끌어와 내부 프로젝트나 팀, 나아가 최종 고객 단위로 비용을 귀속시키고 싶어 했고, 개발자는 스크립트에 그대로 끼워 넣을 수 있는 curl 한 줄을 원했다. 그동안 이런 요구는 스크린샷을 찍거나 인보이스를 수동으로 내려받는 방식으로만 충족됐다. 이제는 빌링 읽기(Billing Read) 권한이 있는 API 토큰을 발급받아 엔드포인트를 호출하면 현재 청구 기간이 제품별로 분해돼 돌아온다.
FOCUS 규격을 택한 이유
주목할 점은 응답의 컬럼 이름을 FinOps 진영의 개방형 비용·사용량 명세인 FOCUS(FinOps Open Cost and Usage Specification)에 맞췄다는 것이다. 대부분의 필드가 FOCUS 컬럼에 직접 대응하도록 설계돼, 이미 다른 공급자의 FOCUS 데이터를 수집해 온 팀이라면 이름과 의미 체계가 익숙하게 느껴진다. 제품 구분은 클라우드플레어 고유 방식으로 묶되 FOCUS는 통제된 어휘를 쓰고, 누적(cumulation) 관련 편의 필드는 FOCUS에서 쿼리 단계의 문제로 다루는 식의 차이가 있으며, 존(zone) 범위 식별자도 적용 가능한 경우에 함께 제공된다.
이런 선택은 생태계 호환을 노린 의도적 결정이다. AWS와 애저, 구글 클라우드, 오라클은 물론 점점 늘어나는 SaaS 공급자들이 이미 FOCUS 형식 익스포트를 제공하고, 진지한 비용 관리 도구들은 이 규격을 공통 언어로 삼는다. 다만 클라우드플레어는 아직 완전한 준수(conformance)를 주장하지 않는다. 명세가 요구하는 몇몇 컬럼이 현재 페이로드에 빠져 있으며, 이를 채우는 일은 로드맵에 올라 있다고 설명했다. '익숙한 형태를 지금 제공하고 완전한 준수는 다음 단계'라는 것이 회사의 표현이다. 실무자 입장에서는 도구 연동은 지금도 되지만, 규격에 엄격하게 의존하는 파이프라인이라면 누락 컬럼을 확인해 두는 편이 안전하다.
연동 사례로는 인프라 비용 관리 플랫폼 밴티지(Vantage)와의 네이티브 통합이 함께 소개됐다. 밴티지는 AI·클라우드·SaaS를 아우르는 30개 이상의 공급자로부터 비용과 사용량 데이터를 수집해 하나의 화면에서 리포팅과 배분, 최적화를 돕는 도구다. 이번 통합에서 밴티지는 빌링 읽기 권한이 있는 읽기 전용 API 토큰으로 클라우드플레어에 연결해 매일 사용량 데이터를 가져오고, 워커스나 R2 같은 제품별, 그리고 존과 계정 단위로 분해한다. 그 결과 클라우드플레어 지출이 기존에 쓰던 비용 리포트, 예산, 비용 알림 안으로 그대로 흘러들어, 어떤 제품이 지출을 견인하는지와 그 비용을 어느 팀·서비스에 귀속할지를 함께 볼 수 있다. 수동 익스포트나 인보이스 업로드, 별도 대시보드 유지 없이 콘솔에서 계정을 연결하는 것으로 끝난다.
실무적으로 무엇이 달라지나
정리하면 이 API의 가치는 두 갈래다. 하나는 자동화 자체에 대한 통제로, 계정에 프로그래매틱 접근을 허용했다면 그것이 무엇을 얼마나 쓰는지도 프로그래매틱하게 봐야 한다는 원칙을 실현한다. 다른 하나는 기존 FinOps 도구 체인과의 결합으로, FOCUS 표준을 매개로 클라우드플레어 지출을 다른 클라우드 지출 옆에 나란히 놓을 수 있다는 점이다. 엔드포인트는 이미 모든 셀프서브 계정에서 활성화돼 있으며 전체 레퍼런스는 클라우드플레어 API 문서에서 확인할 수 있다. 다만 현재는 일 단위 갱신이라 분 단위의 즉각적 비용 추적을 기대하는 워크로드에는 아직 간극이 있고, 완전한 FOCUS 준수 역시 앞으로의 과제로 남아 있다는 점은 도입 시 감안할 부분이다.