Firebase サービスの利用額上限を設定する


このページでは、Firebase プロジェクトが Blaze のお支払いプランの場合に、費用上限予算を設定して管理する方法について説明します。

上限額予算は、Firebase AI LogicFirebase App HostingCloud Functions for FirebaseFirebase Extensions などの一部の Firebase サービスで利用できます。

費用上限を設定する手順に移動

予算について

Google Cloud Billing の予算を作成することで、費用を管理し、想定外の請求を回避できます。予算とは、1 か月あたりに使用する予定の金額です。アラートのみの予算費用上限予算のいずれかになります。

アラートのみの予算

  • 費用が予算に設定されたしきい値に達すると、Cloud Billing メール通知が送信されます

  • 次の点にご注意ください。

    • 予算アラートによってサービスが一時停止されることはありません。予算と予算アラートは、費用をモニタリングし、必要に応じて対処できるようにアラートを送信することを目的としています。たとえば、予算通知を使用して、プロジェクトの請求を無効にすることを検討します。

    • Firebase コンソールで Blaze のお支払いプランにアップグレードすると、アラート専用の予算を設定するよう自動的に求められます。Google Cloud コンソールでアラートのみの予算を手動で設定することもできます。

利用額上限の予算(このページ)

  • 予算の特定のサービスの費用が設定されたしきい値に達すると、Cloud Billingメール通知を送信します。

  • そのサービスの予算の 100% に達すると、Cloud Billingそのサービスをその月の残りの期間一時停止します

  • 次の点にご注意ください。

    • 予算の上限は、Firebase AI LogicFirebase App HostingCloud Functions for FirebaseFirebase Extensions の Firebase サービスでのみ使用できます。

    • 費用上限予算は、Firebase コンソール(このページで説明)または Google Cloud コンソールで手動で設定できます。

利用額上限予算の概要

費用上限予算を設定する前に、このセクションの情報をご確認ください。このセクションには、対象サービスのリストと、考えられる費用上限の状態が含まれています。このページの後半で、費用上限予算の制限事項を確認することもおすすめします。

Google Cloud のドキュメントには、費用上限予算に関するよくある質問の一覧も記載されています。

対象サービス

利用額上限の予算は、次の 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 が利用額上限を適用し(該当するサービスの新しい使用を一時停止)、サービスを再開するために適用された利用額上限が明示的に解除されました。

費用の上限を設定、管理する

  1. 利用額上限予算を構成します。Cloud Billing が特定のサービスに対するプロジェクトの支出を積極的にモニタリングできるように、利用額上限予算を構成します。

  2. アラートと費用上限の適用について理解する。
    プロジェクトの費用が、そのサービスの月額予算の特定のしきい値に達すると、Cloud Billing はアラート メールを送信し、利用額上限を適用します。適用とは、そのサービスの新規利用がその月の残りの期間一時停止されることを意味します。

  3. 必要に応じて、適用された利用額上限を引き上げます。
    その月に一時停止されたサービスの使用を再開する場合は、適用された利用額上限を明示的に引き上げる必要があります。

必要な権限

費用上限予算を設定して管理するには、プロジェクトとそのリンクされた Cloud Billing アカウントに対する管理者レベルのアクセス権が必要です。次のいずれかのオプションで、必要な権限が付与されます。

費用の上限予算を構成する

Cloud Billing がサービスの費用のモニタリングを積極的に開始するには、そのサービスの利用額上限予算を構成する必要があります。プロジェクトがそのサービスの特定の費用のしきい値に達すると、Cloud Billingアラートメールを送信し、利用額上限を適用します

Firebase コンソールを使用して費用上限予算を構成する方法は次のとおりです。

  1. Firebase コンソールでプロジェクトにアクセスし、[ 設定] > [使用量と請求額] > [詳細と設定] ページに移動します。

  2. [サービスレベルの利用額上限] カードに移動します。

  3. 上限を設定するサービスを見つけて、1 か月の予算額を設定し、[構成] をクリックします。

    • 利用額上限の予算は、1 つのプロジェクトと、そのプロジェクト内の1 つの対象サービスに適用されます。

    • 費用上限予算の期間は月単位で、毎月 1 日から始まります。

Google Cloud コンソールを使用して費用上限予算を構成することもできます。

アラートメールと利用額上限の適用

利用額上限予算を構成すると、Cloud Billing はそのサービスのプロジェクトの費用を積極的にモニタリングします。このサービスの上限額予算の次の費用しきい値に基づいて、アラートメールを送信し、上限額を適用します。

  • 設定した予算の 50% と 80%:

    • Cloud Billing は、すべての課金管理者、プロジェクト オーナー、該当する「重要な連絡先」警告アラート メールを送信します
  • 設定した予算の 100%:

    • Cloud Billing利用額上限を適用します。つまり、適用された利用額上限を明示的に引き上げない限り、該当するサービスの新規利用は今月の残りの期間、一時停止されます。

    • Cloud Billing 別のアラートメールを送信します。また、Firebase コンソールと Google Cloud コンソールには、費用上限の適用とサービスの一時停止に関するバナー通知が表示されます。

クライアントサイドの影響とエラー処理

利用額上限の適用によりサービスが一時停止されると、クライアントサイド アプリはそのサービスのエラーをスローし始めます。アプリコードでこれらの例外を適切に処理する必要があります(たとえば、try-catch ブロックを使用します)。

適用されている利用額上限を解除する

利用額上限がトリガーされて適用されると、適用対象サービスのすべての新規利用は、適用された利用額上限を明示的に引き上げない限り、今月の残りの期間、一時停止されます。

Firebase コンソールを使用して、適用された費用上限を引き上げる方法は次のとおりです。

  1. Firebase コンソールでプロジェクトにアクセスし、[ 設定] > [使用量と請求額] > [詳細と設定] ページに移動します。

  2. [サービスレベルの利用額上限] カードに移動します。

  3. 費用上限が適用されているサービスを見つけて、[引き上げ] をクリックします。

Google Cloud コンソールを使用して、適用された費用上限を引き上げることもできます。

費用の上限予算の制限

費用上限予算について理解しておくべき重要な制限事項は次のとおりです。

  • 利用額上限の予算は「上限」ではありません。使用状況レポートのレイテンシにより、費用上限の適用は瞬時には行われず、数分遅れることがあります。この遅延中に発生した費用の超過分は、通常どおり請求されます。予算を絶対的な上限よりも少し低く設定することをおすすめします。

  • プロジェクトとサービス スコープ。利用額上限の予算は、1 つのプロジェクトと、そのプロジェクト内の1 つの対象サービスに適用されます。

    • Cloud Billing アカウント全体、フォルダ、組織、ラベルのレベルで費用上限予算を設定することはできません。

    • 複数のプロジェクトまたは複数のサービスを対象とする単一の費用上限予算を設定することはできません。

    • サービスの利用額上限予算を設定すると、プロジェクトでサービスを操作するすべての方法に適用されます。たとえば、Agent Platform Gemini API (formerly Vertex AI) に予算を設定すると、Firebase SQL Connect、ADK、Genkit などを介したプロジェクトでの API の使用量にも適用されます(Firebase AI Logic を介した使用量だけではありません)。

  • 月間の期間。費用上限予算の期間は月単位で、毎月 1 日から始まります。

  • サービスは毎月デフォルトで再開されます。強制適用された利用額上限を引き上げない場合、サービスは今月のみ一時停止されたままになります。

    • デフォルトでは、翌月の初めに適用された利用額上限が自動的に解除され、サービスが再開されます。

    • ただし、利用額上限の予算設定を調整して、利用額上限が明示的に解除されるまで、利用額上限が無期限に適用され(サービスが一時停止されたままになる)ようにすることはできます。

    デフォルトでは、適用された利用額上限を引き上げない場合、サービスは当月は一時停止されたままになりますが、翌月の初めに自動的に再開されます。ただし、利用額上限が明示的に解除されるまで、利用額上限が適用されたまま(サービスが一時停止されたまま)になるように、利用額上限の予算設定を無期限で調整することはできます。

  • 費用削減とクレジットは含まれません。利用額上限の予算の費用計算は総費用に基づいており、割引やクレジットは含まれません。

お支払い情報の設定がより高度な場合は、Google Cloud ドキュメントで費用上限予算の制限の詳細をご確認ください。