Définir des plafonds de dépenses pour les services Firebase

Preview : Les budgets avec plafond de dépenses sont disponibles en Preview, ce qui signifie qu'ils ne sont soumis à aucun contrat de niveau de service ni à aucune règle d'abandon, et qu'ils peuvent être modifiés de manière non rétrocompatible.

Cette page explique comment configurer et gérer des budgets avec plafond de dépenses lorsque votre projet Firebase est associé au forfait Blaze.

Les budgets avec plafond de dépenses sont disponibles pour les services Firebase suivants : Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase et Firebase Extensions.

Important : Les plafonds de dépenses ne sont pas des limites strictes. En raison de la latence dans les rapports d'utilisation, l'application du plafond de dépenses n'est pas instantanée et peut être retardée de plusieurs minutes. Tous les coûts supplémentaires encourus pendant ce délai seront facturés normalement.
Par conséquent, vous devez définir votre budget légèrement en dessous de votre limite absolue et considérer les plafonds de dépenses comme un outil parmi d'autres pour vous aider à gérer vos coûts et à réduire l'impact des factures inattendues importantes. En savoir plus sur les options d'alerte et de logique supplémentaires

Accéder aux instructions pour configurer un plafond de dépenses

Comprendre les budgets

Vous pouvez contrôler vos coûts et éviter les mauvaises surprises sur votre facture en créant des budgets pour Google Cloud Billing. Les budgets sont des montants monétaires généraux que vous prévoyez de dépenser chaque mois. Il peut s'agir de budgets avec alerte uniquement ou de budgets avec plafond de dépenses.

Budgets avec alerte uniquement

• Si les dépenses atteignent les seuils définis pour votre budget, Cloud Billing envoie des notifications par e-mail.

• Veuillez noter les points suivants :

  • Les alertes de budget ne mettent pas les services en pause. Elles sont destinées à vous aider à surveiller vos coûts et à vous alerter afin que vous puissiez prendre des mesures, si nécessaire. Par exemple, vous pouvez envisager d'utiliser les notifications de budget pour désactiver la facturation sur le projet.

  • Lorsque vous passez au forfait Blaze dans la console Firebase, vous êtes automatiquement invité à configurer un budget avec alerte uniquement. Vous pouvez également configurer manuellement des budgets avec alerte uniquement dans la console Google Cloud.

Budgets avec plafond de dépenses (cette page)

• Si les dépenses atteignent les seuils définis pour votre budget pour un service spécifique, Cloud Billing envoie des notifications par e-mail.

• Si les dépenses atteignent 100 % de votre budget pour ce service, Cloud Billing suspend ce service pour le reste du mois.

• Veuillez noter les points suivants :

  • Les budgets avec plafond de dépenses ne sont disponibles que pour les services Firebase suivants : Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase et Firebase Extensions.

  • Vous pouvez configurer manuellement des budgets avec plafond de dépenses dans la console Firebase (comme décrit sur cette page) ou dans la console Google Cloud.

  • Avant de configurer un budget avec plafond de dépenses, consultez les informations importantes sur les budgets avec plafond de dépenses plus loin sur cette page.

Tous les projets Firebase sont en réalité des projets Google Cloud en coulisses, ce qui signifie que la facturation est partagée entre Firebase et Google Cloud, et que vous pouvez afficher le même projet dans la console Firebase et dans la console Google Cloud.

Présentation des budgets avec plafond de dépenses

Avant de configurer un budget avec plafond de dépenses, consultez les informations de cette section, qui incluent la liste des services éligibles et les états possibles du plafond de dépenses. Nous vous recommandons également de consulter les limites des budgets avec plafond de dépenses plus loin sur cette page.

Vous trouverez également une liste de questions fréquentes sur les budgets avec plafond de dépenses dans la documentation Google Cloud.

Services éligibles

Vous pouvez configurer des budgets avec plafond de dépenses pour les services Firebase suivants :

• Firebase AI Logic : définissez des limites d'accès à Gemini Developer API ou Agent Platform Gemini API (formerly Vertex AI).
• Firebase App Hosting : définissez des limites pour le service Cloud Run sous-jacent.
• Cloud Functions for Firebase : définissez des limites pour le service Cloud Run Functions sous-jacent.
• Firebase Extensions : définissez des limites pour le service Cloud Run Functions sous-jacent.

Nous nous efforçons d'ajouter des services à cette liste de services éligibles aux budgets avec plafond de dépenses. Consultez-la régulièrement.

Remarque : Lorsque vous définissez un budget avec plafond de dépenses pour l'un des services sous-jacents ci-dessus, ce budget s'applique au niveau du projet et à toutes les interactions possibles avec le service dans votre projet. Par exemple, si vous définissez un budget sur Agent Platform Gemini API (formerly Vertex AI), il s'applique également à toute utilisation de cette API dans le projet via Firebase SQL Connect, ADK, Genkit, etc. (et pas seulement à l'utilisation via Firebase AI Logic).

États du plafond de dépenses

Un plafond de dépenses peut avoir l'un des états suivants :

• Configuré : Cloud Billing surveille activement les dépenses de votre projet pour un service spécifique en fonction de votre plafond de dépenses.

• Appliqué : les dépenses de votre projet ont atteint 100 % du budget mensuel que vous avez défini pour ce service. Cloud Billing a donc appliqué le plafond de dépenses. Toute nouvelle utilisation du service pour le reste du mois est suspendue, sauf si le plafond de dépenses appliqué est explicitement levé.

• Levé : Cloud Billing a appliqué le plafond de dépenses (et suspendu toute nouvelle utilisation du service concerné), mais le plafond de dépenses appliqué a été explicitement levé pour réactiver le service.

  Lorsque l'état est Levé, le service s'exécute sans limite de dépense pour le reste du mois, sauf si vous reconfigurez ou augmentez le plafond. Au début du mois suivant, le budget initial du plafond de dépenses est automatiquement réactivé.

Remarque : Si vous modifiez une configuration de plafond de dépenses (même si vous renommez le budget dans la console Google Cloud), le plafond de dépenses repasse à l'état Configuré. Si vos dépenses mensuelles atteignent ou dépassent déjà le seuil de budget, le plafond se déclenche et s'applique immédiatement.

Si vous ne levez pas un plafond de dépenses appliqué, le service restera suspendu pour le mois en cours uniquement. Ensuite, au début du mois suivant, le plafond de dépenses appliqué sera automatiquement réinitialisé et le service reprendra.

Configurer et gérer les plafonds de dépenses

Remarque : Avant de configurer un budget avec plafond de dépenses, consultez la présentation des budgets avec plafond de dépenses plus haut sur cette page.

1. Configurez un budget avec plafond de dépenses.
   Configurez un budget avec plafond de dépenses pour que Cloud Billing puisse commencer à surveiller activement les dépenses de votre projet pour un service spécifique.

2. Comprendre les alertes et l'application du plafond de dépenses
   Si les dépenses de votre projet atteignent certains seuils de votre budget mensuel pour ce service, Cloud Billing envoie des e-mails d'alerte et applique le plafond de dépenses. L'application signifie que toute nouvelle utilisation de ce service est suspendue pour le reste du mois.

3. Vous pouvez lever un plafond de dépenses appliqué (ou augmenter son budget).
   Si vous souhaitez réactiver un service suspendu au cours de ce mois (sans limite ou avec un budget plus élevé), vous devez lever explicitement le plafond de dépenses appliqué.

Autorisations requises

Pour configurer et gérer un budget avec plafond de dépenses, vous devez disposer d'un accès de niveau administrateur au projet et au compte Cloud Billing associé. Chacune des options suivantes vous accorde les autorisations requises :

• Option 1 : rôle d'administrateur de compte de facturation sur le compte Cloud Billing associé au projet

• Option 2 : Rôle de propriétaire du projet sur le projet dans lequel vous souhaitez configurer des budgets avec plafond de dépenses

• Option 3 : la combinaison suivante de rôles IAM au niveau du compte et du projet Cloud Billing :

  • Rôle Gestionnaire des coûts du compte de facturation sur le compte Cloud Billing associé au projet

    et

  • Rôle Éditeur de projet sur le projet pour lequel vous souhaitez configurer des budgets avec plafond de dépenses

Configurer un budget avec plafond de dépenses

Pour que Cloud Billing commence à surveiller activement vos dépenses pour un service, vous devez configurer un budget de plafond de dépenses pour ce service. Si votre projet atteint certains seuils de dépenses pour ce service, Cloud Billing enverra des e-mails d'alerte et appliquera le plafond de dépenses.

Pour configurer des budgets avec plafond de dépenses à l'aide de la console Firebase, procédez comme suit :

1. Accédez à votre projet dans la console Firebase, puis accédez à la page Paramètres > Utilisation et facturation > Détails et paramètres.

2. Accédez à la fiche Plafonds de dépenses au niveau du service.

3. Recherchez le service que vous souhaitez plafonner, définissez le montant de votre budget mensuel, puis cliquez sur Configurer.

   • Un budget avec plafond de dépenses est limité à un seul projet et à un seul service éligible dans ce projet.

   • La période d'un budget avec plafond de dépenses est mensuelle, à compter du premier jour de chaque mois.

Attention : Les budgets avec plafond de dépenses ne sont pas des "plafonds stricts". En raison de la latence dans les rapports d'utilisation, l'application du plafond de dépenses n'est pas instantanée. Tous les coûts supplémentaires encourus pendant ce délai seront facturés normalement. Envisagez de définir votre budget légèrement en dessous de votre limite absolue.

Notez que vous pouvez également configurer des budgets avec plafond de dépenses à l'aide de la console Google Cloud.

E-mails d'alerte et application du plafond de dépenses

Une fois que vous avez configuré un budget avec plafond de dépenses, Cloud Billing surveille activement les dépenses de votre projet pour ce service. Il enverra des alertes par e-mail et appliquera le plafond de dépenses en fonction des seuils de dépenses suivants pour le budget du plafond de dépenses de ce service.

• 50 % et 80 % du budget défini :

  • Cloud Billing envoie des e-mails d'alerte à tous les administrateurs de facturation, aux propriétaires de projets et à tout contact essentiel concerné.

• 100 % du budget défini :

  • Cloud Billing applique le plafond de dépenses, ce qui signifie que toute nouvelle utilisation du service concerné sera suspendue pour le reste du mois, sauf si vous levez explicitement le plafond de dépenses appliqué.

  • Cloud Billing envoie un autre e-mail d'alerte. De plus, la consoleFirebase et la consoleGoogle Cloud affichent des notifications sous forme de bannière concernant l'application du plafond de dépenses et la suspension du service.

Impact côté client et gestion des erreurs

Lorsqu'un service est suspendu en raison de l'application d'un plafond de dépenses, votre application côté client commence à générer des erreurs pour ce service. Vous devez gérer ces exceptions de manière appropriée dans le code de votre application (par exemple, à l'aide de blocs try-catch).

Lever un plafond de dépenses appliqué

Si un plafond de dépenses est déclenché et appliqué, toute nouvelle utilisation du service concerné est suspendue pour le reste du mois, sauf si vous levez explicitement le plafond de dépenses appliqué.

Voici comment lever un plafond de dépenses appliqué à l'aide de la console Firebase :

1. Accédez à votre projet dans la console Firebase, puis accédez à la page Paramètres > Utilisation et facturation > Détails et paramètres.

2. Accédez à la fiche Plafonds de dépenses au niveau du service.

3. Recherchez le service pour lequel un plafond de dépenses est appliqué, puis cliquez sur Lever.

Tenez compte des points suivants lorsque vous supprimez un plafond de dépenses :

• Délai possible avant la reprise du service : la reprise complète de certains services peut prendre jusqu'à une heure après la levée du plafond de dépenses appliqué.
• Aucune limite pour le reste du mois : si vous levez un plafond de dépenses appliqué et n'apportez aucune autre modification, le service s'exécute sans limite de dépenses pour le reste du mois. Au début du mois suivant, le plafond de dépenses est automatiquement réinitialisé à l'état Configuré avec le budget d'origine, et le service reprend.
• Si vous ne levez pas un plafond de dépenses appliqué, le service reste suspendu pour le mois en cours uniquement. Au début du mois suivant, le plafond de dépenses est automatiquement réinitialisé à l'état Configuré avec le budget d'origine, et le service reprend.

Notez que vous pouvez également lever les plafonds de dépenses appliqués à l'aide de la console Google Cloud.

Augmenter un plafond de dépenses après l'application d'une mesure

Si votre plafond de dépenses est appliqué et que vous souhaitez reprendre le service avec un budget plus élevé pour le reste du mois (par exemple, en augmentant votre limite de 10 $ à 20 $), vous ne pouvez pas modifier le montant du budget tant que le plafond est à l'état Appliqué. Vous devez d'abord lever le plafond avant de définir une limite plus élevée.

Voici comment réactiver un service et augmenter son plafond de dépenses :

1. Supprimer le plafond de dépenses : dans la console Firebase ou Google Cloud, recherchez le service concerné, puis cliquez sur Supprimer.

   Le plafond de dépenses passera à l'état "En attente" pendant la suppression de l'application.

2. Attendez que le plafond de dépenses soit levé : patientez quelques minutes et actualisez la page jusqu'à ce que l'état du plafond de dépenses indique Levé.

   Le service sera réactivé. Selon le service, cela peut prendre jusqu'à une heure.

3. Mettre à jour le montant du budget : modifiez le plafond de dépenses en saisissant le nouveau montant de votre budget mensuel, plus élevé. Enregistrez les modifications.

Remarques importantes concernant l'augmentation d'un plafond :

• Lié au total des dépenses du mois en cours : le nouveau montant du budget est toujours lié au total des dépenses cumulées pour le mois en cours, y compris les dépassements de coûts encourus pendant les retards de reporting avant l'application de la limite.

• Définissez un budget supérieur aux dépenses du mois en cours : assurez-vous que votre nouveau budget est supérieur à ce que vous avez déjà dépensé ce mois-ci (y compris les dépassements). Sinon, le plafond se déclenchera et suspendra à nouveau le service immédiatement.

• Calcul du budget restant : votre budget restant pour le mois correspond au nouveau montant du seuil moins vos dépenses totales jusqu'à présent. Exemple :

  1. Vous avez défini un plafond de dépenses de 10 $ pour Cloud Functions for Firebase.

  2. Vos dépenses atteignent 10 $ (plus un dépassement de 1 $ pendant le délai de reporting, soit un total de 11 $). Le plafond est appliqué, ce qui suspend vos fonctions.

  3. Vous confirmez que le trafic est légitime. Vous supprimez donc la limite et attendez que l'état indique Supprimée.

  4. Vous modifiez le plafond de dépenses pour le définir sur 20 $. Lorsque vous enregistrez cette modification, le plafond de dépenses repasse à l'état Configuré.

  5. Vos fonctions continuent de s'exécuter sous le nouveau plafond de 20 $, avec un budget restant d'environ 9 $ pour le mois (limite de 20 $ moins 11 $ déjà cumulés).

  6. Le mois suivant, le plafond de dépenses restera fixé à 20 €.

Limites des budgets avec plafond de dépenses

Voici quelques limites importantes à connaître concernant les budgets avec plafond de dépenses :

• Les budgets avec plafond de dépenses ne sont pas des "limites strictes". En raison de la latence dans les rapports d'utilisation, l'application du plafond de dépenses n'est pas instantanée et peut être retardée de plusieurs minutes. Tous les coûts supplémentaires encourus pendant ce délai seront facturés normalement. Envisagez de définir votre budget légèrement en dessous de votre limite absolue.

• Champ d'application : projet et service. Un budget avec plafond de dépenses est limité à un seul projet et à un seul service éligible dans ce projet.

  • Vous ne pouvez pas définir de budget avec plafond de dépenses au niveau du compte Cloud Billing entier, ni au niveau du dossier, de l'organisation ou du libellé.

  • Vous ne pouvez pas définir un seul budget avec plafond de dépenses qui couvrira plusieurs projets ou plusieurs services.

  • Lorsque vous définissez un budget avec plafond de dépenses pour un service, il s'applique à toutes les façons dont vous pouvez interagir avec le service dans le projet. Par exemple, si vous définissez un budget sur Agent Platform Gemini API (formerly Vertex AI), il s'applique également à toute utilisation de cette API dans le projet via Firebase SQL Connect, ADK, Genkit, etc. (et pas seulement à l'utilisation via Firebase AI Logic).

• Période mensuelle : La période d'un budget avec plafond de dépenses est mensuelle et commence le premier jour de chaque mois.

• Le service reprend automatiquement chaque mois.

  • Si vous ne levez pas un plafond de dépenses appliqué, le service restera suspendu pour le mois en cours uniquement. Au début du mois suivant, le plafond de dépenses appliqué est automatiquement réinitialisé à l'état Configuré avec le budget d'origine, et le service reprend.

  • Si vous levez un plafond de dépenses appliqué au cours du mois et que vous ne modifiez pas le budget, le service s'exécute sans limite de dépenses pour le reste du mois. Le plafond de dépenses est automatiquement réinitialisé à l'état Configuré avec le budget d'origine, et le service reprend.

• N'inclut pas les économies ni les crédits. Les calculs de coût pour un budget avec plafond de dépenses sont basés sur les coûts bruts et n'incluent pas les économies ni les crédits.

Si vous disposez d'une configuration de facturation plus avancée, vous trouverez plus d'informations sur les limites des budgets avec plafond de dépenses dans la documentation Google Cloud.