사용량 및 청구

Kisenon이 측정하는 것, 무료 허용량, 그리고 콘솔이 이를 보여주는 방식.

Kisenon은 네 가지 차원을 측정하고 이를 조직별로 집계합니다. 컴퓨트는 크기 가중 가동 시간으로 측정됩니다 — 컴퓨트 수치를 읽기 전에 CU-시간이란 무엇인가를 먼저 확인하세요. 콘솔은 사용량을 보여주며, 매월 무료 사용량을 넘는 사용은 요금 계약에 따라 청구됩니다 — 아래 청구 상태를 참조하세요.

측정 대상

컨트롤 플레인은 프로젝트별로 세 가지 차원을 샘플링하고 이를 조직별로 집계합니다:

차원	단위	측정 방식
컴퓨트	CU-시간	각 엔드포인트의 서버 측 런타임(Postgres `now()`)에서 매분 재계산되며, 시간 단위로 버킷화되고 컴퓨트 크기로 가중됩니다.
스토리지	GB-월	스토리지 계층의 프로젝트별 크기에서 5분마다 폴링됩니다.
브랜치	브랜치-월	프로젝트별로 매일 02:00 UTC에 한 번 샘플링됩니다.

CU-시간이란 무엇인가

CU-시간은 엔드포인트가 깨어 있던 한 시간에 그 엔드포인트의 컴퓨트 크기를 곱한 값입니다. 정의는 이것이 전부입니다.

크기와 가동 시간을 측정할 뿐 실제 수행한 작업량은 측정하지 않습니다. 이 계측은 CPU도, 메모리도, IOPS도, 연결 수도 전혀 읽지 않습니다. 따라서 깨어 있지만 유휴 상태인 엔드포인트는 같은 크기의 완전 부하 엔드포인트와 정확히 같은 속도로 CU-시간을 쌓습니다. 한 시간 동안 모든 코어를 포화시킨 엔드포인트와 그 한 시간에 SELECT 1 하나만 처리한 엔드포인트의 청구액은 동일합니다.

컴퓨트 청구액을 실제로 바꾸는 것:

가동 시간. 일시 중지된 엔드포인트는 아무것도 쌓지 않습니다. 잠든 시간은 무료입니다.
컴퓨트 크기. 더 큰 엔드포인트는 깨어 있는 시간당 비례해서 더 많이 쌓습니다.

따라서 지렛대는 쿼리 효율이 아니라 유휴 시 일시 중지입니다. 일시 중지되는 엔드포인트는 멈추는 순간 CU-시간 누적을 멈추고, 하루 대부분을 잠들어 있는 프로젝트는 계속 깨어 있는 프로젝트의 일부분만큼만 비용이 듭니다. 쿼리를 CPU를 덜 쓰도록 튜닝해도 CU-시간 청구액은 내려가지 않습니다. 엔드포인트를 더 일찍 일시 중지시키면 내려갑니다.

스토리지와 브랜치 수는 샘플링 창 안에서 안정적이므로 더 성긴 주기로도 충분합니다.

샘플은 현재 청구 주기에 대한 컴퓨트, 스토리지, 브랜치 사용량을 조직별 단일 뷰로 집계합니다 — 청구 페이지가 렌더링하는 숫자입니다.

무료 등급

모든 조직은 매월 무료 사용량으로 시작합니다. 조직별로 프로젝트 수 상한도 적용될 수 있습니다: 상한이 활성화되면, 등록된 결제 수단이 없는 조직은 고정된 수의 프로젝트로 제한됩니다; 한계에 도달하면 또 다른 프로젝트를 생성할 때 free_allowance_exhausted(HTTP 403)가 반환됩니다. 등록된 결제 수단이 있는 조직은 상한이 없습니다. 정확한 상한은 하드코딩된 숫자가 아니라 배포 설정이므로, 시간이 지남에 따라 조정할 수 있습니다.

한 주기의 측정 사용량이 올라감에 따라, 콘솔은 세 가지 임계값에서 본문 위에 점차 강해지는 배너를 표시합니다 — 컨트롤 플레인이 주기별 알림 로그에 기록하는 것과 동일한 80 / 95 / 100 퍼센트입니다:

80% — 노란색 알림: "이번 기간에 무료 등급의 80% 이상을 사용했습니다."
95% — 서비스가 중단되기 전에 결제 수단을 추가하라는 황색 경고.
100% — 빨간색 소진 상태: 결제 수단이 추가될 때까지 컴퓨트가 일시 중지될 수 있습니다.

각 배너는 세션 동안 닫을 수 있으며 결제 수단 추가로 연결됩니다.

조직 청구 페이지

모든 조직에는 /orgs/{id}/billing에 청구 페이지가 있으며, 조직 내비게이션에서 접근할 수 있습니다. 사용량 데이터가 있으면 차원별로 사용량 / 허용량 바(80% 미만은 녹색, 80–95%는 황색, 95% 이상은 빨간색)와 선택적인 기간 말 예상 마커, 예상 인보이스 항목, 그리고 현재 플랜 및 결제 수단을 렌더링합니다.

청구 관리

셀프서비스 청구가 라이브 상태입니다. 결제 수단이 등록되면, 조직 청구 페이지(설정 → 청구)에 Stripe 호스팅 고객 포털을 여는 청구 관리 버튼이 표시됩니다. 포털에서 다음을 할 수 있습니다:

결제 수단 업데이트 또는 교체.
인보이스와 영수증 보기.
청구 주소와 세금 ID 편집.
해지.

카드가 추가되기 전에는 페이지에 대신 결제(Checkout) 버튼이 표시됩니다(결제 수단 추가); 둘은 상호 배타적입니다.

할 수 있는 사람: 조직 소유자 또는 billing 역할만 — admin, member, viewer는 안 됩니다.

참고로, 컨트롤 플레인은 다음을 노출합니다:

POST /v1/billing/portal-session → { url }

이는 고객 포털로 가는 URL을 반환하며; 포털은 이후 항상 조직 청구 페이지로 당신을 되돌려 보냅니다.

프로젝트별 비용 (쇼백)

청구 페이지에는 사용량을 프로젝트별로 세분화하는 프로젝트별 비용 카드가 포함되어 있습니다. 프로젝트별로 네 가지 측정 차원을 보고합니다:

차원	단위
컴퓨트	CU-시간
스토리지	GB-월
브랜치	브랜치-월
이그레스	GB

크레딧 및 할인 포함 토글은 뷰를 총액과 순액 사이에서 전환합니다 — 순액 뷰는 무료 허용량과 볼륨 할인을 비례 배분하여 적용합니다. 이것은 표시 렌즈입니다: 푸터는 항상 총 소계, 무료 허용량, 볼륨 할인, 그리고 순 합계를 보여줍니다.

데이터는 일 단위입니다: 기간은 전체 시작 날짜(YYYY-MM-DD)로 키가 지정됩니다. 사용량은 전역 측정 저장소에서 가져오므로, 프로젝트가 삭제된 후에도 프로젝트의 비용은 계속 보입니다.

청구 상태

측정 사용량은 프로젝트별로 수집되고, 조직별로 집계되며, 요금 계약에 따라 Stripe를 통해 청구됩니다:

매월 무료 사용량 안의 사용은 청구되지 않습니다; 이를 넘는 사용은 유닛 단위로 측정되며, 대량 사용에는 볼륨 할인이 자동 적용됩니다.
컨트롤 플레인의 청구 엔드포인트(/v1/billing/customer)가 사용량 배너와 조직 청구 페이지를 뒷받침합니다 — 둘은 동일한 소스에서 읽으므로, 모두 현재 주기의 실제 숫자를 반영합니다.
무료 등급 프로젝트 상한을 해제하고 무료 사용량을 넘어 계속하려면, 조직 청구 페이지에서 결제 수단을 추가하세요.