사용량과 청구
무엇에 요금이 붙는지, 사용량과 청구서를 어떻게 확인하는지 정리했습니다.
요금은 앱이 아니라 팀 단위로 모아서 계산합니다. 한 팀에 앱이 여러 개 있으면 모두 합산됩니다.
무엇을 측정하나요
| 구분 | 측정 항목 |
|---|---|
| CDN 트래픽 | 전송량, 요청 수 |
| 컴퓨트 (서버 실행) | CPU 사용 시간, 할당된 메모리, 호출 수 |
앱의 도메인별 트래픽은 방문자가 실제로 요청한 도메인(예: www.example.com) 기준으로 집계합니다.
사용량 보기
ntro usage # 이번 청구 주기
ntro usage --from 2026-09-01 --to 2026-10-01 --by day # 기간·일별
ntro billing # 플랜·결제 상태
ntro invoices # 청구서 목록ntro usage는 이번 청구 주기의 사용량, 플랜에 포함된 무료 사용량, 예상 금액을 보여 줍니다. 예상 금액은 확정된 청구서가 아닙니다.--from·--to에는 UTC 날짜(YYYY-MM-DD)나 RFC3339 시각을 씁니다. 시작일은 포함, 종료일은 포함하지 않습니다. 위 예시는 9월 한 달입니다.--by region|app|day로 리전·앱·날짜별로 나눠 볼 수 있습니다.- 다른 팀을 보려면
--team <팀>을 붙이세요.
팀의 사용량·청구 정보는 owner, member, billing만 볼 수 있습니다. viewer는 비용을 뺀 앱별 트래픽 분석만 볼 수 있습니다. 자세한 내용은 팀과 권한 문서를 참고하세요.
플랜
| 플랜 | 내용 |
|---|---|
free (기본) | 일정량의 무료 사용량이 포함됩니다. |
pro | 월 플랫폼 기본 요금과 월 사용 크레딧이 있으며, 크레딧 적용 후 남은 사용액이 청구됩니다. |
현재 가격은 가격 페이지나 공개 가격 API에서 확인하세요.
- 플랜 변경과 결제 수단 관리는 팀의
owner또는billing만 할 수 있습니다. - 결제 수단은 CLI가 아니라 콘솔에서 입력합니다.
- 유료 플랜에서 다른 플랜으로 바꾸면 이번 청구 주기가 끝날 때 바뀌도록 예약될 수 있습니다.
크레딧과 청구 통화
1크레딧 = 1 USD(미국 달러)입니다. 사용량 단가, 포함량, 플랜의 월 크레딧, 좌석 가격, Flat Rate CDN 단계 요금은 통화와 무관한 하나의 요금 카탈로그에 정의합니다. 카탈로그는 적용 시작일별로 버전을 관리합니다.
운영자는 청구 통화마다 통화별 가격을 별도로 게시합니다. 각 버전에는 1크레딧의 고정 가격과 플랜별 월 플랫폼 요금을 직접 입력합니다. 실시간 환율을 적용하지 않습니다. 예를 들어 KRW의 크레딧 가격이 1,400원이면 20크레딧은 28,000원에 해당합니다. 월 플랫폼 요금은 크레딧에서 환산하는 것이 아니라 별도로 정합니다.
사용 요금은 청구 주기 시작 시점에 유효한 카탈로그와 통화별 가격으로 계산합니다. 사용 내역서, 청구서, 지출 예산은 크레딧이 아니라 팀의 청구 통화로 표시합니다.
두 종류의 크레딧
- 플랜의 월 크레딧은 해당 주기의 트래픽·컴퓨트 사용 요금에만 적용하며 사용액을 넘어서 차감하지 않습니다. 플랫폼 요금이나 Flat Rate CDN 단계 요금에는 적용되지 않고, 남은 크레딧은 이월되지 않습니다.
- 운영자가 지급한 팀 크레딧은 특정 통화에 묶이지 않는 잔액입니다. 어떤 청구 통화에서도 각종 요금을 포함한 청구서 총액을 줄입니다. 먼저 지급한 크레딧부터 차감하는 선입선출(FIFO) 방식이며, 남은 잔액은 통화를 바꾼 뒤에도 다음 청구서에 사용할 수 있습니다. 해당 청구서의 주기 시작 시점에 유효한 고정 크레딧 가격으로 환산합니다.
가격 페이지에서는 월 크레딧과 선택한 통화의 환산 금액을 함께 볼 수 있습니다. 최종 청구액은 청구 통화로 확정하며, 사용액은 측정 항목·지역별로 통화의 최소 단위에 맞춰 사사오입합니다.
지역별 단가
요금 카탈로그의 단가는 나라 단위로 정합니다. 서버가 실행되는 위치는 kr-icn(서울), us-pdx(오리건), de-fra(프랑크푸르트)처럼 <나라>-<도시> 형식의 사이트 코드로 표시되지만, 카탈로그의 단가는 kr, jp, us, de 같은 나라 코드를 씁니다.
- 예: 서울에서 실행된 컴퓨트와 한국 CDN 트래픽은 모두
kr단가를 씁니다. - 카탈로그에 해당 나라가 없으면 기본 단가
*를 씁니다. - 사용량 조회에서 컴퓨트는 사이트 코드(
kr-icn), 트래픽은 나라 코드(kr)로 표시됩니다.
예산 초과 시 일시 중지
예산은 팀의 청구 통화로 계산한 트래픽·컴퓨트 종량제 사용액에서 플랜의 월 크레딧을 차감한 금액을 기준으로 합니다. 플랫폼 요금과 Flat Rate CDN 단계 요금은 제외합니다. 운영자가 지급한 크레딧은 이후 청구서에서 차감하므로 예산 알림·일시 중지의 기준 사용액을 줄이지 않습니다.
지출 예산의 pause_on_budget을 켜면 사용액이 예산의 100%에 도달했을 때 프로덕션을 일시 중지하도록 요청합니다. 즉시 끊기는 상한은 아니므로, 중지되기까지의 짧은 시간 동안 사용량이 조금 더 늘어날 수 있습니다.
예산의 50%, 75%, 100% 도달 알림을 서명된 HTTPS 웹훅, Slack, Discord로 받을 수 있습니다. 팀마다 최대 10개의 목적지를 등록하며 목적지 관리와 예산 설정은 별개입니다. 자세한 내용은 웹훅 문서를 참고하세요.
결제 영수증 이메일
총액이 0보다 큰 청구서가 결제 완료 상태가 되면 팀의 청구 이메일로 영수증을 보냅니다. Stripe, NicePay, 결제 복구·대사, 운영자 처리 중 어느 경로로 결제를 확인하든 같습니다. 같은 결제 알림을 다시 받아도 영수증을 중복 발송하지 않습니다. 총액이 0인 청구서에는 결제 영수증을 보내지 않으며, 영수증 이메일 도입 전에 이미 결제된 청구서도 다시 보내지 않습니다.
영수증 이메일은 현재 영어로 발송합니다. 이메일 전송에 실패해도 완료된 결제가 취소되지는 않습니다.
영수증에는 다음 정보가 들어갑니다.
- 청구서 번호, 청구 기간(UTC 날짜), 결제일, 결제 수단. 확인 가능한 경우 카드 식별 정보도 표시합니다.
- 청구 통화로 표시한 항목별 금액. 크레딧 차감액은 음수로 표시합니다.
- 소계, 세금(있는 경우 세금 명칭·세율), 결제 총액.
- 청구서에 저장된 청구 대상 정보가 있는 경우 그 정보.
- 팀 청구 페이지 링크와, 제공되는 경우 결제사의 영수증 링크.
영수증은 청구 고객 정보에 저장된 이메일 주소로 보내며, 계정 이메일과 다른 주소일 수 있습니다.
API 참고: 금액 필드
API 응답에서 이름이 _minor로 끝나는 금액은 통화의 최소 단위 정수입니다(예: USD는 센트). 화면에 표시할 때는 응답의 통화와 소수 자릿수를 함께 확인하세요. 크레딧 수량과 가격의 소수 값은 최소 단위 정수가 아니라 문자열입니다. 자세한 내용은 공개 가격 필드 문서를 참고하세요.