이 페이지에서는 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 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 콘솔을 사용하여 강제 지출 한도를 해제할 수도 있습니다.
지출 한도 예산의 제한사항
다음은 지출 한도 예산에 대해 알아야 할 중요한 제한사항입니다.
지출 한도 예산은 '엄격한 상한'이 아닙니다. 사용량 보고의 지연 시간으로 인해 비용 한도 시행이 즉시 이루어지지 않으며 몇 분 정도 지연될 수 있습니다. 이 지연 중에 발생한 비용 초과분은 정상적으로 청구됩니다. 예산을 절대 한도보다 약간 낮게 설정하는 것이 좋습니다.
프로젝트 및 서비스 범위 지정 지출 한도 예산은 단일 프로젝트와 해당 프로젝트 내의 요건을 충족하는 단일 서비스로 범위가 지정됩니다.
전체 Cloud Billing 계정 수준 또는 폴더, 조직, 라벨 수준에서는 지출 한도 예산을 설정할 수 없습니다.
여러 프로젝트 또는 여러 서비스를 포함하는 단일 지출 한도 예산을 설정할 수 없습니다.
서비스에 지출 한도 예산을 설정하면 프로젝트에서 서비스와 상호작용할 수 있는 모든 방식에 적용됩니다. 예를 들어 Agent Platform Gemini API (formerly Vertex AI)에 예산을 설정하면 Firebase SQL Connect, ADK, Genkit 등을 통해 프로젝트에서 해당 API를 사용하는 경우에도 적용됩니다(Firebase AI Logic를 통한 사용뿐만 아니라).
월별 기간. 지출 한도 예산의 기간은 매월 1일에 시작되는 월별입니다.
서비스는 매월 자동으로 재개됩니다. 강제 지출 한도를 해제하지 않으면 서비스가 이번 달에만 일시중지된 상태로 유지됩니다. 그러면 다음 달 초에 적용된 지출 한도가 자동으로 해제되고 서비스가 재개됩니다.
할인 및 크레딧은 포함되지 않습니다. 지출 한도 예산의 비용 계산은 총비용을 기준으로 하며 절감액과 크레딧은 포함되지 않습니다.
고급 결제 설정을 사용하는 경우 Google Cloud 문서에서 지출 한도 예산의 제한사항에 관해 자세히 알아볼 수 있습니다.