초과 캡

​

캡 정하기

• 캡 금액 결제 기간당 달러. 이 위로는 요청을 거절합니다.
• Notify at Nora가 결제 담당에게 이메일하는 임계값(기본은 캡의 80%).

# 월 $50 초과 캡
nora billing set-overage-cap --cents 5000

# 캡 지우기: 플랜 기본 사용
nora billing set-overage-cap --clear

​

캡에 닿으면

• 미터링 대상 새 요청이 HTTP 402 Payment Required를 돌려줍니다.
• 스케줄 실행이 멈춥니다.
• 파운더리 파이프라인이 멈춥니다.
• 진행 중이던 실행은 정상적으로 끝냅니다.
• 채팅 트래픽이 친절한 에러 메시지를 받습니다(“이 워크스페이스가 사용량 캡에 닿았습니다. 관리자에게 연락하세요”).

• 결제 기간이 넘어가서 사용량 카운터가 초기화됩니다.
• 캡을 올립니다.
• 캡을 지웁니다(무제한).

​

캡 알림

• 워크스페이스 Owner.
• 결제 담당.
• Settings → Billing → Notification recipients의 주소.

Trigger: overage_percentage > 80%
Channel: Slack (#nora-billing)

​

플랜 기본과 커스텀 캡

• 캡을 안 정하면 플랜의 기본 초과 한도를 씁니다.
• 캡을 정하면 커스텀 값이 이깁니다. 플랜 기본보다 낮든 높든요.

​

언제 캡을 거나

• 고정 예산의 Free / Team 월 상한에 캡을 겁니다.
• Dev / 스테이징 워크스페이스 폭주 스크립트가 예산을 태우지 않게 낮게 겁니다.
• 새 워크스페이스 한 달 사용량을 볼 때까지 보수적으로 겁니다.
• 고객 계약의 Enterprise 스코프가 번지지 않게 계약별로 겁니다.

​

언제 캡을 안 거나

• 트래픽을 못 내다보는 프로덕션 워크스페이스 캡에 닿으면 곧 장애입니다. 실제 트래픽을 삼킬 캡보다 알림 + 수동 상향을 고르세요.
• 컴플라이언스가 중요한 워크로드 캡에 닿으면 인시던트가 됩니다. 대신 알림 + 모니터링을 두세요.

​

캡과 실행당 비용 제한

• Flow 전역 max cost Flow 별 캡(Flow 설정 참고).
• Agent max cost Agent 별 캡(nora agents update --set-max-cost 참고).

• Agent 별 캡이 어느 한 Agent도 폭주 루프를 못 돌게 막습니다.
• Flow 전역 캡이 어느 한 Flow도 비용을 몰아 쓰지 못하게 막습니다.
• 초과 캡이 워크스페이스 전체의 폭주를 막습니다.

​

캡 올리기

​

비용 내다보기

# 지금 초과 퍼센트
state=$(nora billing state --json)
used=$(echo "$state" | jq '.overage_cents_used')
cap=$(echo "$state" | jq '.overage_cap_cents')
pct=$(echo "$used $cap" | awk '{ if ($2 > 0) printf "%.1f\n", $1/$2*100; else print 0 }')
echo "Overage: ${pct}%"

​

관련

• 결제 개요
• 인보이스
• 알림 임계값을 넘으면 알립니다.
• nora billing set-overage-cap CLI 레퍼런스.