이 페이지에서는 Firebase 프로젝트가 Blaze 요금제를 사용하는 경우 지출 상한선 예산을 설정하고 관리하는 방법을 설명합니다.
지출 상한선 예산은 Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, Firebase Extensions와 같은 일부 Firebase 서비스에서 사용할 수 있습니다.
예산 이해하기
Google Cloud Billing 예산을 만들어 비용을 관리하고 예상하지 못한 금액이 청구되는 것을 방지할 수 있습니다. 예산은 매달 지출할 계획인 일반적인 금액이며 알림형 예산 또는 지출 상한선 예산일 수 있습니다.
알림형 예산
지출이 예산에 설정된 기준에 도달하면 Cloud Billing에서 이메일 알림을 전송합니다.
다음에 유의하세요.
예산 알림은 서비스를 일시중지하지 않습니다. 비용을 모니터링하고 필요할 경우 조치를 취할 수 있도록 알림을 제공하기 위한 것입니다. 예를 들어 예산 알림을 사용하여 프로젝트의 결제를 사용 중지하는 방법을 고려할 수 있습니다.
Firebase Console에서 Blaze 요금제로 업그레이드하면 알림형 예산을 설정하라는 메시지가 자동으로 표시됩니다. Google Cloud 콘솔에서 알림형 예산을 수동으로 설정할 수도 있습니다.
지출 한도 예산(이 페이지)
지출이 특정 서비스의 예산에 설정된 기준에 도달하면 Cloud Billing에서 이메일 알림을 전송합니다.
지출이 해당 서비스의 예산의 100% 에 도달하면 Cloud Billing에서 해당 월의 나머지 기간 동안 해당 서비스를 일시중지합니다.
다음에 유의하세요.
지출 상한선 예산은 Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, Firebase Extensions Firebase 서비스에만 사용할 수 있습니다.
Firebase 콘솔(이 페이지에 설명된 대로) 또는 Google Cloud 콘솔에서 지출 상한 예산을 수동으로 설정할 수 있습니다.
- 지출 한도 예산을 설정하기 전에 이 페이지 뒷부분에 있는 지출 한도 예산에 관한 중요 정보를 검토하세요.
지출 한도 예산 개요
지출 상한선 예산을 설정하기 전에 이 섹션의 정보를 검토하세요. 여기에는 사용 가능한 서비스 목록과 가능한 지출 상한선 상태가 포함됩니다. 이 페이지 뒷부분에 있는 지출 한도 예산의 제한사항도 검토하는 것이 좋습니다.
Google Cloud 문서에서 지출 상한선 예산에 관한 FAQ 목록을 확인할 수도 있습니다.
운영 가능 서비스
다음 Firebase 서비스에 지출 한도 예산을 설정할 수 있습니다.
- Firebase AI Logic: Gemini Developer API 또는 Agent Platform Gemini API (formerly Vertex AI)에 대한 액세스 한도를 설정합니다.
- Firebase App Hosting: 기본 Cloud Run 서비스에 한도를 설정합니다.
- Cloud Functions for Firebase: 기본 Cloud Run Functions 서비스에 한도를 설정합니다.
- Firebase Extensions: 기본 Cloud Run Functions 서비스에 한도를 설정합니다.
Google은 지출 상한선 예산에 적합한 서비스 목록을 추가하기 위해 노력하고 있으므로 이 목록을 정기적으로 확인하세요.
지출 한도 상태
지출 상한액은 다음 상태 중 하나일 수 있습니다.
구성됨: Cloud Billing에서 지출 한도 예산을 기준으로 특정 서비스에 대한 프로젝트의 지출을 적극적으로 모니터링합니다.
적용됨: 프로젝트의 지출이 해당 서비스에 설정된 월별 예산의 100% 에 도달하여 Cloud Billing에서 지출 한도를 적용했습니다. 적용된 지출 한도가 명시적으로 해제되지 않는 한 이번 달 남은 기간 동안 서비스의 신규 사용이 일시중지됩니다.
해제됨: Cloud Billing에서 지출 한도를 적용하고 해당 서비스의 새 사용을 일시중지했지만, 서비스를 재개하기 위해 적용된 지출 한도가 명시적으로 해제되었습니다.
해제됨 상태에서는 한도를 재구성하거나 늘리지 않는 한 해당 월의 나머지 기간 동안 지출 한도 없이 서비스가 실행됩니다. 다음 달 초에 원래 지출 한도 예산이 자동으로 다시 사용 설정됩니다.
적용된 지출 한도를 해제하지 않으면 서비스가 이번 달에만 일시중지된 상태로 유지됩니다. 그런 다음 다음 달 초에 적용된 지출 한도가 자동으로 재설정되고 서비스가 재개됩니다.
지출 한도 설정 및 관리
지출 한도 예산을 구성합니다.
Cloud Billing에서 특정 서비스에 대한 프로젝트의 지출을 적극적으로 모니터링할 수 있도록 지출 한도 예산을 구성합니다.알림 및 지출 한도 적용 이해하기
프로젝트 지출이 해당 서비스의 월별 예산 중 특정 기준점에 도달하면 Cloud Billing에서 알림 이메일을 전송하고 지출 한도를 적용합니다. 적용은 해당 서비스의 신규 사용이 해당 월의 나머지 기간 동안 일시중지됨을 의미합니다.원하는 경우 적용된 지출 한도를 해제하거나 예산을 늘립니다.
해당 월에 일시중지된 서비스의 사용을 재개하려면(한도 없이 또는 더 높은 예산으로) 적용된 지출 한도를 명시적으로 해제해야 합니다.
필수 권한
지출 상한선 예산을 설정하고 관리하려면 프로젝트 및 연결된 Cloud Billing 계정에 대한 관리자 수준 액세스 권한이 필요합니다. 다음 옵션 중 하나를 사용하면 필요한 권한이 부여됩니다.
옵션 1: 프로젝트에 연결된 Cloud Billing 계정의 결제 계정 관리자 역할
옵션 2: 지출 상한선 예산을 구성하려는 프로젝트에 대한 프로젝트 소유자 역할
옵션 3: Cloud Billing 계정 및 프로젝트 수준 IAM 역할의 다음 조합:
프로젝트에 연결된 Cloud Billing 계정의 결제 계정 비용 관리자 역할
및
지출 상한선 예산을 구성하려는 프로젝트에 대한 프로젝트 편집자 역할
지출 한도 예산 구성
Cloud Billing에서 서비스 지출을 적극적으로 모니터링하려면 해당 서비스의 지출 한도 예산을 구성해야 합니다. 프로젝트가 해당 서비스의 특정 지출 기준에 도달하면 Cloud Billing에서 알림 이메일을 전송하고 지출 한도를 적용합니다.
Firebase 콘솔을 사용하여 지출 상한선 예산을 구성하는 방법은 다음과 같습니다.
Firebase Console에서 프로젝트에 액세스한 다음
설정 > 사용량 및 결제 > 세부정보 및 설정 페이지로 이동합니다.서비스 수준 지출 한도 카드로 이동합니다.
한도를 설정할 서비스를 찾고 월별 예산 금액을 설정한 후 구성을 클릭합니다.
지출 한도 예산은 단일 프로젝트와 해당 프로젝트 내의 단일 적격 서비스로 범위가 지정됩니다.
지출 상한선 예산의 기간은 매월 1일부터 시작하는 월별입니다.
Google Cloud 콘솔을 사용하여 지출 상한선 예산을 구성할 수도 있습니다.
알림 이메일 및 지출 한도 시행
지출 한도 예산을 구성하면 Cloud Billing에서 해당 서비스에 대한 프로젝트의 지출을 적극적으로 모니터링합니다. 해당 서비스의 지출 한도 예산에 대한 다음 지출 기준점에 따라 알림 이메일을 전송하고 지출 한도를 적용합니다.
설정된 예산의 50% 및 80%:
- Cloud Billing는 모든 결제 관리자, 프로젝트 소유자, 관련 '필수 연락처'에 경고 알림 이메일을 전송합니다.
설정된 예산의 100%:
Cloud Billing는 지출 한도를 적용합니다. 즉, 적용된 지출 한도를 명시적으로 해제하지 않는 한 해당 서비스의 신규 사용은 이번 달 남은 기간 동안 일시중지됩니다.
Cloud Billing 다른 알림 이메일을 보냅니다. 또한 Firebase 콘솔과 Google Cloud 콘솔에는 지출 한도 적용 및 일시중지된 서비스에 대한 배너 알림이 표시됩니다.
클라이언트 측 영향 및 오류 처리
적용된 지출 한도로 인해 서비스가 일시중지되면 클라이언트 측 앱에서 해당 서비스에 대한 오류가 발생하기 시작합니다. 앱 코드에서 이러한 예외를 적절하게 처리해야 합니다(예: try-catch 블록 사용).
적용된 지출 한도 해제
지출 한도가 트리거되고 적용되면 명시적으로 적용된 지출 한도를 해제하지 않는 한 해당 서비스의 모든 새 사용이 이번 달 남은 기간 동안 일시중지됩니다.
Firebase 콘솔을 사용하여 적용된 지출 한도를 해제하는 방법은 다음과 같습니다.
Firebase Console에서 프로젝트에 액세스한 다음
설정 > 사용량 및 결제 > 세부정보 및 설정 페이지로 이동합니다.서비스 수준 지출 한도 카드로 이동합니다.
지출 한도가 적용된 서비스를 찾은 다음 해제를 클릭합니다.
Google Cloud 콘솔을 사용하여 적용된 지출 한도를 해제할 수도 있습니다.
시정 조치 후 지출 한도 상향
지출 한도가 적용되고 해당 월의 나머지 기간 동안 더 높은 예산으로 서비스를 재개하려는 경우(예: 한도를 $10에서 $20로 늘림) 한도가 적용됨 상태인 동안에는 예산 금액을 수정할 수 없습니다. 더 높은 한도를 설정하려면 먼저 한도를 해제해야 합니다.
서비스를 재개하고 지출 한도를 늘리는 방법은 다음과 같습니다.
지출 상한선 해제: Firebase 콘솔 또는 Google Cloud 콘솔에서 시행된 서비스를 찾은 다음 해제를 클릭합니다.
시정 조치가 삭제되는 동안 지출 한도가 대기 중 상태로 전환됩니다.
해제가 완료될 때까지 기다리기: 몇 분 정도 기다린 후 지출 한도 상태가 해제됨으로 표시될 때까지 페이지를 새로고침합니다.
서비스가 재개됩니다. 서비스에 따라 최대 1시간이 걸릴 수 있습니다.
예산 금액 업데이트: 더 높은 새 월별 예산 금액을 입력하여 지출 상한선 예산을 수정합니다. 변경사항을 저장합니다.
한도 상향 시 중요한 고려사항:
이번 달 총 지출에 연결됨: 새 예산 금액은 한도가 적용되기 전에 보고 지연 중에 발생한 비용 초과분을 포함하여 이번 달의 총 누적 지출에 계속 연결됩니다.
이번 달 지출보다 높은 예산 설정: 새 예산이 이번 달에 이미 지출한 금액(초과분 포함)보다 높은지 확인합니다. 그렇지 않으면 한도가 트리거되고 서비스가 즉시 다시 일시중지됩니다.
잔여 예산 계산: 해당 월의 잔여 예산은 새 기준액에서 지금까지의 총 지출액을 뺀 금액입니다. 예를 들면 다음과 같습니다.
Cloud Functions for Firebase에 지출 한도를 10달러로 설정했습니다.
지출이 $10에 도달합니다(보고 지연 중 초과분 $1를 더해 총 $11). 한도가 적용되어 함수가 일시중지됩니다.
트래픽이 합법적인지 확인한 후 한도를 해제하고 상태가 해제됨으로 표시될 때까지 기다립니다.
지출 한도를 $20로 업데이트합니다. 이 수정사항을 저장하면 지출 한도가 구성됨 상태로 재설정됩니다.
함수는 새로운 $20 한도 내에서 계속 실행되며, 해당 월의 남은 예산은 약 $9($20 한도에서 이미 발생한 $11를 뺀 금액)입니다.
다음 달에는 지출 한도 예산이 20달러 기준점을 유지합니다.
지출 한도 예산의 제한사항
지출 상한선 예산에 대해 이해해야 할 중요한 제한사항은 다음과 같습니다.
지출 한도 예산은 '엄격한 상한'이 아닙니다. 사용량 보고의 지연 시간으로 인해 지출 한도 적용은 즉시 이루어지지 않으며 몇 분 정도 지연될 수 있습니다. 이 지연 기간 동안 발생한 비용 초과분은 정상적으로 청구됩니다. 예산을 절대 한도보다 약간 낮게 설정하는 것이 좋습니다.
프로젝트 및 서비스 범위. 지출 한도 예산은 단일 프로젝트와 해당 프로젝트 내의 단일 적격 서비스로 범위가 지정됩니다.
전체 Cloud Billing 계정 수준이나 폴더, 조직 또는 라벨 수준에서는 지출 상한선 예산을 설정할 수 없습니다.
여러 프로젝트 또는 여러 서비스를 포괄하는 단일 지출 한도 예산을 설정할 수 없습니다.
서비스에 지출 한도 예산을 설정하면 프로젝트에서 서비스와 상호작용하는 모든 방식에 적용됩니다. 예를 들어 Agent Platform Gemini API (formerly Vertex AI)에 예산을 설정하면 Firebase AI Logic를 통한 사용뿐만 아니라 Firebase SQL Connect, ADK, Genkit 등을 통한 프로젝트의 해당 API 사용에도 적용됩니다.
월간 기간. 지출 한도 예산의 기간은 매월 1일부터 시작되는 월별 기간입니다.
서비스는 매월 자동으로 재개됩니다.
적용된 지출 한도를 해제하지 않으면 서비스가 이번 달에만 일시중지된 상태로 유지됩니다. 다음 달 초에 적용된 지출 한도가 원래 예산과 함께 구성됨 상태로 자동으로 재설정되고 서비스가 재개됩니다.
해당 월에 적용된 지출 한도를 해제하고 예산을 변경하지 않으면 해당 월의 나머지 기간 동안 지출 한도 없이 서비스가 실행되고 지출 한도가 원래 예산과 함께 구성됨 상태로 자동 재설정되며 서비스가 재개됩니다.
절감액 및 크레딧은 포함되지 않습니다. 지출 한도 예산의 비용 계산은 총비용을 기준으로 하며 절감액과 크레딧은 포함되지 않습니다.
고급 결제 설정이 있는 경우 Google Cloud 문서에서 지출 상한선 예산의 제한사항에 대한 자세한 내용을 확인할 수 있습니다.