Vercel 을 Hobby 에서 Pro 로 올리고 나니 제일 궁금한 건 하나였습니다. "이번 달에 $20 말고 돈이 더 나갈까?" 대시보드를 뒤져도 되지만, 터미널에서 vercel usage 한 줄이면 이번 결제 주기의 사용량과 비용을 항목별 · 프로젝트별로 볼 수 있습니다.
이 글은 그 명령으로 실제 사용량을 읽어 보고, 비용이 어디서 나가는지 찾은 기록입니다. Vercel CLI 64.7.0 기준입니다.
어떻게 보나 — vercel usage 하나면 됩니다
로그인(vercel login)만 돼 있으면 바로 됩니다.
vercel usage
자주 쓰는 옵션은 이 정도입니다.
| 옵션 | 하는 일 |
|---|---|
--group-by project | 프로젝트별로 나눠 보기 (region 도 된다) |
--breakdown daily | 날짜별로 나눠 보기 (weekly · monthly 도 된다) |
--since 7d · --until | 기간 지정. 기본은 이번 결제 주기 처음부터 지금까지 |
--json | 스크립트에서 쓰기 좋게 JSON 으로 |
출력은 어떻게 읽나 — 크레딧, 인프라, 구독 세 덩어리
Pro 첫날 돌려 본 결과를 줄이면 이렇습니다.
Billing cycle: Oct 31–Nov 30, 2026
Accrued through Oct 31, 2026 in USD, before credits and discounts.
Current credit balance
Used $1.41 of $20.00
Remaining $18.59
Infrastructure subtotal $1.39
Pro (1 license) $20.00
Estimated total $21.39
여기서 헷갈리기 쉬운 게 두 가지입니다.
- Pro 요금 $20 안에 사용량 크레딧 $20 이 들어 있습니다.
Used $1.41 of $20.00이 그 크레딧입니다. 인프라 사용량은 이 크레딧에서 먼저 빠지고, 넘친 만큼만 추가로 청구됩니다. before credits and discounts. 아래Estimated total $21.39는 크레딧을 빼기 전 금액입니다. 크레딧 안에서 끝나면 실제로 나가는 건 구독료 $20 뿐입니다.
어느 프로젝트가 쓰나 — --group-by project
프로젝트가 여러 개면 이게 제일 쓸모 있습니다.
vercel usage --group-by project
제 팀은 웹 프로젝트가 여러 개인데, 결과는 한쪽으로 쏠려 있었습니다.
| 프로젝트 | 하루 | 비율 |
|---|---|---|
| 가장 큰 웹 (Next.js, 상세 페이지 수천 장) | $1.04 | 75% |
| 두 번째 웹 | $0.27 | 19% |
| 이 블로그 (정적 생성) | $0.03 | 2% |
두 번째 웹은 $0.27 중 $0.16 이 빌드였습니다. 그날 배포를 여러 번 했을 뿐, 운영 비용은 하루 $0.1 정도였습니다. 이 블로그는 정적 페이지라 거의 0 입니다.
무엇에 돈이 나가나 — 1위는 ISR Writes 였습니다
가장 큰 웹 프로젝트의 항목을 보면 이렇습니다.
| 항목 | 하루 사용량 | 비용 | 뜻 |
|---|---|---|---|
| ISR Writes | 5.8만 번 | $0.30 | 캐시된 페이지를 새로 그려 저장한 횟수 |
| Observability Events | 19.2만 건 | $0.23 | 함수 실행 · 요청 관측 기록 |
| Fast Origin Transfer | 0.68GB | $0.16 | 함수 · ISR 이 CDN 으로 보낸 양 |
| Build CPU Minutes | 46.5분 | $0.14 | 배포 빌드 시간 |
| Fluid Provisioned Memory | 8.46GB·시간 | $0.12 | 함수가 떠 있던 시간 × 메모리 |
1위가 ISR Writes 였습니다. 하루 5.8만 번이면 분당 40번꼴로 페이지를 다시 그렸다는 뜻입니다. 이 프로젝트의 상세 페이지는 revalidate 가 5분이라, 검색 로봇이 수천 장을 돌 때마다 시간이 지난 페이지를 계속 새로 그린 것으로 보고 있습니다. 데이터가 바뀔 때는 이미 요청형 갱신(revalidateTag)을 쓰고 있어서, 시간 기준을 길게 늘리는 걸 검토하고 있습니다.
ISR 이 왜 늘 다시 그려지는지 헷갈린다면 ISR 인데 매번 렌더된다면 글도 같이 보세요. 그 글은 캐시가 아예 안 되던 문제였고, 이번 숫자는 캐시는 되지만 너무 자주 새로 그리는 문제입니다.
한 달 비용 예상은 언제 하나 — 첫날 숫자로는 하지 않습니다
하루 $1.39 를 30일로 곱하면 약 $42 입니다. 크레딧 $20 을 넘으니 덜컥할 수 있는데, 그날은 사정이 있었습니다.
- 배포를 많이 해서 빌드만 126분이었습니다.
- API 서버가 20분 멈춘 장애가 있어서, 웹 함수가 응답을 오래 기다렸습니다. 메모리 항목이 여기서 부풀었을 것입니다.
그래서 며칠 쌓인 뒤 날짜별로 다시 보는 게 맞습니다.
vercel usage --breakdown daily --group-by project
--breakdown daily 로 보면 Pro 구독료 $20 이 하루 $0.67 씩 나뉘어 찍히니, 인프라 항목만 따로 보면 됩니다.
하나 더. Hobby 시절 사용량은 이 명령으로 못 봅니다. --since 14d 처럼 Pro 이전 기간을 넣으면 이런 에러가 납니다.
Error: Billing cost data is unavailable for 2026-10-17 through 2026-10-31.
This does not mean usage was zero. It usually means the team has no active
subscription for that range …
요금 데이터가 없다는 뜻이지 사용량이 0 이었다는 뜻이 아닙니다.
돈이 더 나가는 게 걱정되면 — 예산 상한과 일시정지
대시보드의 팀 설정에서 Spend Management(Edit team budget)로 추가 사용 상한을 정할 수 있습니다. 제 화면엔 $200 이 들어 있었습니다.
- 상한만 정하면 알림만 옵니다. 50% · 75% · 100% 에 닿을 때 알림이 오고, 그 자체로 결제를 막지는 않습니다.
- "Pause production deployments" 를 켜야 실제로 멈춥니다. 대신 상한에 닿는 순간 팀의 모든 운영 사이트가 방문자에게 안 열립니다.
| 방식 | 장점 | 단점 |
|---|---|---|
| 상한 낮게 + 일시정지 켜기 | 돈이 더 안 나감 | 트래픽이 몰리면 사이트가 꺼짐 |
| 상한 조금 두기 + 일시정지 끄기 | 사이트는 안 꺼짐, 알림으로 미리 앎 | 상한까지는 나갈 수 있음 |
저는 사이트가 갑자기 꺼지는 쪽이 소액보다 손해라고 봐서, 상한을 작게 두고 알림으로 지켜보는 쪽이 낫다고 생각합니다.
정리
| 무엇 | 명령 · 내용 |
|---|---|
| 이번 달 사용량 | vercel usage |
| 프로젝트별 | vercel usage --group-by project |
| 날짜별 추세 | vercel usage --breakdown daily |
| 크레딧 읽기 | Pro $20 안에 사용량 크레딧 $20, Used … of $20.00 이 그것. 합계는 크레딧 빼기 전 금액 |
| 제 경우 1위 | ISR Writes — 짧은 revalidate × 로봇 방문 |
| 예상은 | 첫날 말고 며칠 쌓인 뒤 날짜별로 |
| 걱정되면 | Spend Management 상한(알림) + 필요하면 일시정지 |
대시보드를 열지 않아도 터미널에서 바로 보이니, 배포가 잦은 주에는 한 번씩 돌려 보면 좋습니다. 숫자가 튀면 --group-by project 로 어느 프로젝트인지부터 보세요.