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


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

利用額上限予算は、Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions の一部の Firebase サービスで利用できます: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, and Firebase Extensions.

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

予算について

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

アラートのみの予算

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

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

利用額上限予算（このページ）

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

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

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

    • 利用額上限予算は、以下の Firebase サービスでのみ使用できます: Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions。

    • 利用額上限予算は、 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 サービスに上限を設定します。

利用額上限予算の対象サービスのリストに追加する作業を進めていますので、このリストを定期的にご確認ください。

利用額上限のステータス

利用額上限は、次のいずれかの状態になります。

  • 構成済み: Cloud Billing は、利用額上限予算に基づいて、特定のサービスに対するプロジェクトの 費用を積極的にモニタリングしています。
  • 適用済み: プロジェクトの費用がそのサービスの月額予算の 100% に達したため、Cloud Billing は利用額上限を適用しました。 適用された利用額上限が明示的に解除されない限り、その月の残りの期間、サービスの新規利用は一時停止されます。
  • 解除済み: Cloud Billing は利用額上限を適用していましたが（該当するサービスの新規 利用を一時停止していました）、サービスを再開するために、適用された利用額上限が明示的に 解除されました。

利用額上限を設定して管理する

  1. 利用額上限予算を構成します。
    Cloud Billing が特定のサービスに対するプロジェクトの費用を積極的に モニタリングを開始できるように、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%:

  • 設定した予算の 100%:

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

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

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

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

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

利用額上限がトリガーされて適用されると、適用された利用額上限を明示的に解除しない限り、その月の残りの期間、該当するサービスの すべての新規利用が一時停止されます。

Firebase コンソールを使用して、適用された利用額上限を解除する方法は次のとおりです。

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

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

  3. 適用された利用額上限のあるサービスを見つけて、[解除] をクリックします。

適用された利用額上限は、 コンソールGoogle Cloudを使用して解除することもできます。

利用額上限予算の制限事項

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

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

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

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

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

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

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

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

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

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

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

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

より高度な課金設定を行っている場合は、 利用額上限予算の制限事項 について詳しくはGoogle Cloudドキュメントをご確認ください。