이 페이지에서는 Firebase 프로젝트에서 Blaze 요금제를 사용하는 경우 지출 한도 예산을 설정하고 관리하는 방법을 설명합니다.
Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, Firebase Extensions 등 일부 Firebase 서비스에 대해 지출 한도 예산을 사용할 수 있습니다.
예산 이해
Google Cloud Billing 예산을 만들면 비용을 관리하고 예상치 못한 청구를 피할 수 있습니다. 예산은 매달 지출할 계획인 일반적인 금액이며, 알림 전용 예산 또는 지출 한도 예산일 수 있습니다.
알림 전용 예산
지출이 예산에 설정된 기준에 도달하면 Cloud Billing 이메일 알림을 전송합니다.
다음에 유의하세요.
예산 알림은 서비스를 일시중지하지 않습니다. 비용을 모니터링하고 필요한 경우 조치를 취할 수 있도록 알림을 제공하기 위한 것입니다. 예를 들어 예산 알림을 사용하여 프로젝트의 결제를 사용 중지하는 방법을 고려할 수 있습니다.
Firebase 콘솔에서 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 서비스의 한도를 설정합니다.
지출 한도 예산에 사용할 수 있는 서비스 목록이 추가될 예정이니 정기적으로 다시 확인해 주세요.
지출 한도 상태
지출 한도는 다음 상태 중 하나일 수 있습니다.
구성됨: 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 콘솔에서 프로젝트에 액세스한 다음
설정 > 사용량 및 결제 > 세부정보 및 설정 페이지로 이동합니다.서비스 수준 지출 한도 카드로 이동합니다.
한도를 설정할 서비스를 찾아 월 예산 금액을 설정한 다음 구성을 클릭합니다.
지출 한도 예산은 단일 프로젝트와 해당 프로젝트 내의 요건을 충족하는 단일 서비스로 범위가 지정됩니다.
지출 한도 예산의 기간은 매월 1일에 시작되는 월별입니다.
Google Cloud 콘솔을 사용하여 비용 한도 예산을 구성할 수도 있습니다.
알림 이메일 및 지출 한도 시행
지출 한도 예산을 구성하면 Cloud Billing에서 해당 서비스에 대한 프로젝트의 지출을 적극적으로 모니터링합니다. 이 서비스의 지출 한도 예산에 대한 다음 지출 기준에 따라 알림 이메일을 보내고 지출 한도를 적용합니다.
설정된 예산의 50% 및 80%:
- Cloud Billing 모든 결제 관리자, 프로젝트 소유자, 관련 '필수 연락처'에게 경고 알림 이메일을 전송합니다.
설정된 예산의 100%:
Cloud Billing 지출 한도를 적용합니다. 즉, 명시적으로 적용된 지출 한도를 해제하지 않는 한 해당 서비스의 신규 사용이 이번 달 남은 기간 동안 일시중지됩니다.
Cloud Billing 다른 알림 이메일을 보냅니다. 또한 Firebase 콘솔과 Google Cloud 콘솔에 지출 한도 시행 및 서비스 일시중지에 관한 배너 알림이 표시됩니다.
클라이언트 측 영향 및 오류 처리
적용된 지출 한도로 인해 서비스가 일시중지되면 클라이언트 측 앱에서 해당 서비스에 대한 오류가 발생하기 시작합니다. 앱 코드에서 이러한 예외를 적절하게 처리해야 합니다 (예: try-catch 블록 사용).
강제 적용된 지출 한도 해제
지출 한도가 트리거되고 적용되면 적용되는 서비스의 새 사용량이 적용된 지출 한도를 명시적으로 해제하지 않는 한 이번 달 남은 기간 동안 일시중지됩니다.
Firebase 콘솔을 사용하여 강제 지출 한도를 해제하는 방법은 다음과 같습니다.
Firebase 콘솔에서 프로젝트에 액세스한 다음
설정 > 사용량 및 결제 > 세부정보 및 설정 페이지로 이동합니다.서비스 수준 지출 한도 카드로 이동합니다.
강제 지출 한도가 적용된 서비스를 찾아 해제를 클릭합니다.
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 SQL Connect, ADK, Genkit 등을 통해 프로젝트에서 해당 API를 사용하는 경우에도 적용됩니다(Firebase AI Logic를 통한 사용뿐만 아님).
월별 기간. 지출 한도 예산의 기간은 매월 1일에 시작되는 월별입니다.
서비스는 매월 자동으로 재개됩니다.
강제 적용된 지출 한도를 해제하지 않으면 서비스가 이번 달에만 일시중지된 상태로 유지됩니다. 다음 달이 시작되면 적용된 지출 한도가 원래 예산으로 구성됨 상태로 자동 재설정되고 서비스가 재개됩니다.
이번 달에 강제 적용된 지출 한도를 해제하고 예산을 변경하지 않으면 이번 달의 나머지 기간 동안 지출 한도 없이 서비스가 실행되고, 지출 한도가 원래 예산으로 구성됨 상태로 자동 재설정되며 서비스가 재개됩니다.
할인 및 크레딧은 포함되지 않습니다. 지출 한도 예산의 비용 계산은 총비용을 기준으로 하며 절감액과 크레딧은 포함되지 않습니다.
고급 결제 설정을 사용하는 경우 Google Cloud 문서에서 지출 한도 예산의 제한사항에 관해 자세히 알아볼 수 있습니다.