Konfigurowanie limitów wydatków na usługi Firebase


Na tej stronie dowiesz się, jak konfigurować budżety z limitem wydatków i nimi zarządzać, gdy Twój projekt w Firebase korzysta z abonamentu Blaze.

Limity wydatków są dostępne w przypadku tych wybranych usług Firebase:Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase i Firebase Extensions.

 Przejdź do instrukcji konfigurowania limitu wydatków

Informacje o budżetach

Możesz kontrolować koszty i unikać niespodzianek na rachunku, tworząc budżety Google Cloud Billing. Budżety to ogólne kwoty pieniężne, które planujesz wydawać co miesiąc. Mogą to być budżety tylko z alertami lub budżety z limitem wydatków.

Budżety tylko z alertami

Budżety z limitem wydatków (ta strona)

  • Jeśli wydatki osiągną określone progi budżetu dla konkretnej usługi, Cloud Billing wyśle powiadomienia e-mail.

  • Jeśli wydatki osiągną 100% budżetu na daną usługę, Cloud Billing wstrzyma tę usługę na pozostałą część miesiąca.

  • Pamiętaj:

    • Limity wydatków są dostępne tylko w przypadku tych usług Firebase:Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase i Firebase Extensions.

    • Budżety z limitem wydatków możesz skonfigurować ręcznie w konsoli Firebase (jak opisano na tej stronie) lub w konsoli Google Cloud.

Omówienie budżetów z limitem wydatków

Zanim skonfigurujesz budżet z limitem wydatków, zapoznaj się z informacjami w tej sekcji, w tym z listą kwalifikujących się usług i możliwych stanów limitu wydatków. Zalecamy też zapoznanie się z ograniczeniami budżetów z limitem wydatków w dalszej części tej strony.

Listę najczęstszych pytań dotyczących budżetów z limitem wydatków znajdziesz też w dokumentacji Google Cloud.

Kwalifikujące się usługi

Budżety z limitami wydatków można skonfigurować w przypadku tych usług Firebase:

  • Firebase AI Logic: ustaw limity dostępu do Gemini Developer API lub Agent Platform Gemini API (formerly Vertex AI).
  • Firebase App Hosting: ustaw limity w usłudze bazowej Cloud Run.
  • Cloud Functions for Firebase: ustaw limity dla usługi funkcji Cloud Run.
  • Firebase Extensions: ustaw limity dla usługi funkcji Cloud Run.

Pracujemy nad dodaniem do tej listy kwalifikujących się usług w przypadku budżetów z limitem wydatków, więc regularnie sprawdzaj, czy nie pojawiły się nowe.

Stany limitu wydatków

Limit wydatków może mieć jeden z tych stanów:

  • Skonfigurowano: Cloud Billing aktywnie monitoruje wydatki projektu w przypadku konkretnej usługi na podstawie budżetu limitu wydatków.

  • Egzekwowany: wydatki w Twoim projekcie osiągnęły 100% ustawionego miesięcznego budżetu na tę usługę, więc Cloud Billing nałożył limit wydatków. Każde nowe użycie usługi w pozostałej części miesiąca zostanie wstrzymane, chyba że egzekwowany limit wydatków zostanie wyraźnie zniesiony.

  • Zniesiony: Cloud Billing limit wydatków został wyegzekwowany (i wstrzymano każde nowe użycie odpowiedniej usługi), ale wyegzekwowany limit wydatków został wyraźnie zniesiony, aby wznowić usługę.

    W stanie Zniesiony usługa działa bez limitu wydatków do końca miesiąca, chyba że ponownie skonfigurujesz lub zwiększysz limit. Na początku następnego miesiąca pierwotny budżet z limitem wydatków zostanie automatycznie ponownie włączony.

Jeśli nie zniesiesz egzekwowanego limitu wydatków, usługa pozostanie wstrzymana tylko w bieżącym miesiącu. Na początku następnego miesiąca egzekwowany limit wydatków zostanie automatycznie zresetowany, a usługa zostanie wznowiona.

Konfigurowanie limitów wydatków i zarządzanie nimi

  1. Skonfiguruj budżet z limitem wydatków.
    Skonfiguruj budżet z limitem wydatków, aby Cloud Billing mogła aktywnie monitorować wydatki projektu na określoną usługę.

  2. Informacje o alertach i egzekwowaniu limitu wydatków
    Jeśli wydatki projektu osiągną określone progi miesięcznego budżetu na tę usługę, Cloud Billing wysyła e-maile z alertami i egzekwuje limit wydatków. Egzekwowanie oznacza, że każde nowe użycie tej usługi zostanie wstrzymane na pozostałą część miesiąca.

  3. Opcjonalnie możesz znieść egzekwowany limit wydatków (lub zwiększyć budżet).
    Jeśli chcesz wznowić korzystanie z wstrzymanej usługi w danym miesiącu (bez limitu lub w ramach wyższego budżetu), musisz wyraźnie znieść obowiązujący limit wydatków.

Wymagane uprawnienia

Aby skonfigurować budżet z limitem wydatków i nim zarządzać, musisz mieć dostęp administracyjny do projektu i połączonego z nim konta Cloud Billing. Wymagane uprawnienia możesz uzyskać w jeden z tych sposobów:

Konfigurowanie budżetu z limitem wydatków

Aby usługa Cloud Billing aktywnie monitorowała Twoje wydatki na daną usługę, musisz skonfigurować dla niej budżet z limitem wydatków. Jeśli Twój projekt osiągnie określone progi wydatków na daną usługę, Cloud Billing wyśle e-maile z alertami i wymusi limit wydatków.

Aby skonfigurować budżety z limitem wydatków za pomocą konsoli Firebase:

  1. Otwórz projekt w Firebase konsoli, a następnie kliknij Ustawienia > Użycie i płatności > Szczegóły i ustawienia.

  2. Otwórz kartę Limity wydatków na poziomie usługi.

  3. Znajdź usługę, dla której chcesz ustawić limit, określ kwotę budżetu miesięcznego, a następnie kliknij Skonfiguruj.

    • Budżet limitu wydatków jest ograniczony do jednego projektu i jednej kwalifikującej się usługi w tym projekcie.

    • Zakres czasu dla budżetu z limitem wydatków to miesiąc, który rozpoczyna się pierwszego dnia każdego miesiąca.

Pamiętaj, że budżety z limitami wydatków możesz też konfigurować w Google Cloudkonsoli.

E-maile z alertami i egzekwowanie limitu wydatków

Po skonfigurowaniu budżetu z limitem wydatków usługa Cloud Billing będzie aktywnie monitorować wydatki projektu na tę usługę. Będzie wysyłać e-maile z alertami i egzekwować limit wydatków na podstawie tych progów wydatków w przypadku budżetu z limitem wydatków dla tej usługi:

  • 50% i 80% ustawionego budżetu:

    • Cloud Billing wysyła e-maile z alertami ostrzegawczymi do wszystkich administratorów płatności, właścicieli projektów i odpowiednich „kontaktów niezbędnych”.
  • 100% – ustawiony budżet:

    • Cloud Billing egzekwuje limit wydatków, co oznacza, że każde nowe użycie odpowiedniej usługi zostanie wstrzymane na pozostałą część miesiąca, chyba że zniesiesz egzekwowany limit wydatków.

    • Cloud Billing wysyła kolejny e-mail z alertem. W konsoli Firebase i konsoli Google Cloud wyświetlają się też banery z powiadomieniami o wyegzekwowaniu limitu wydatków i wstrzymaniu usługi.

Wpływ po stronie klienta i obsługa błędów

Gdy usługa zostanie wstrzymana z powodu egzekwowania limitu wydatków, aplikacja po stronie klienta zacznie zgłaszać błędy dotyczące tej usługi. W kodzie aplikacji należy odpowiednio obsługiwać te wyjątki (np. za pomocą bloków try-catch).

Znoszenie wyegzekwowanego limitu wydatków

Jeśli limit wydatków zostanie osiągnięty i wyegzekwowany, całe nowe wykorzystanie danej usługi zostanie wstrzymane na pozostałą część miesiąca, chyba że wyraźnie zniesiesz wyegzekwowany limit wydatków.

Aby znieść wymuszony limit wydatków za pomocą konsoli Firebase:

  1. Otwórz projekt w Firebase konsoli, a następnie kliknij Ustawienia > Użycie i płatności > Szczegóły i ustawienia.

  2. Otwórz kartę Limity wydatków na poziomie usługi.

  3. Znajdź usługę z obowiązującym limitem wydatków i kliknij Wzrost.

Pamiętaj, że możesz też zwiększyć egzekwowane limity wydatków za pomocą Google Cloudkonsoli.

Zwiększanie limitu wydatków po jego egzekwowaniu

Jeśli limit wydatków jest egzekwowany, a Ty chcesz wznowić usługę z wyższym budżetem do końca miesiąca (np. zwiększyć limit z 10 PLN do 20 PLN), nie możesz edytować kwoty budżetu, gdy limit jest w stanie Egzekwowany. Zanim ustawisz wyższy limit, musisz najpierw znieść limit.

Aby wznowić usługę i zwiększyć jej limit wydatków:

  1. Zwiększanie limitu wydatków: w konsoli Firebase lub Google Cloud znajdź wymuszoną usługę i kliknij Zwiększ.

    Podczas usuwania egzekwowania limit wydatków będzie w stanie oczekiwania.

  2. Poczekaj na zakończenie zwiększania limitu: odczekaj kilka minut i odśwież stronę, aż stan limitu wydatków zmieni się na Zwiększony.

    Usługa zostanie wznowiona. W zależności od usługi może to potrwać do godziny.

  3. Zaktualizuj kwotę budżetu: edytuj budżet limitu wydatków, wpisując nową, wyższą kwotę budżetu miesięcznego. Zapisz zmiany.

Ważne kwestie dotyczące zwiększania limitu:

  • Powiązany z łącznymi wydatkami w bieżącym miesiącu: nowa kwota budżetu jest nadal powiązana z łącznymi wydatkami zgromadzonymi w bieżącym miesiącu, w tym z wszelkimi przekroczeniami kosztów poniesionymi w okresie opóźnień w raportowaniu przed wprowadzeniem limitu.

  • Ustaw budżet wyższy niż wydatki w bieżącym miesiącu: upewnij się, że nowy budżet jest wyższy niż wydatki w bieżącym miesiącu (w tym przekroczenia). W przeciwnym razie limit zostanie aktywowany, a usługa zostanie natychmiast ponownie wstrzymana.

  • Obliczanie pozostałego budżetu: pozostały budżet na dany miesiąc to nowa kwota progu pomniejszona o dotychczasowe łączne wydatki. Przykład:

    1. Ustawiasz limit wydatków w wysokości 10 USD w usłudze Cloud Functions for Firebase.

    2. Twoje wydatki osiągną 10 USD (plus 1 USD przekroczenia w okresie opóźnienia raportowania, co daje łącznie 11 USD). Limit zostanie zastosowany, a funkcje zostaną wstrzymane.

    3. Potwierdzasz, że ruch jest prawidłowy, więc zdejmujesz limit i czekasz, aż stan zmieni się na Zdjęty.

    4. Zmieniasz limit wydatków na 20 USD. Gdy zapiszesz tę zmianę, limit wydatków zostanie zresetowany do stanu Skonfigurowano.

    5. Funkcje będą nadal działać w ramach nowego limitu 20 PLN, a na ten miesiąc pozostanie Ci około 9 PLN budżetu (limit 20 PLN minus 11 PLN już wykorzystanych).

    6. W następnym miesiącu limit wydatków będzie nadal wynosić 20 PLN.

Ograniczenia budżetów z limitem wydatków

Oto ważne ograniczenia budżetów z limitem wydatków:

  • Budżety z limitami wydatków nie są „limitami maksymalnymi”. Ze względu na opóźnienia w raportowaniu wykorzystania egzekwowanie limitu wydatków nie jest natychmiastowe i może być opóźnione o kilka minut. Wszelkie przekroczenia kosztów, które wystąpią w tym czasie, zostaną obciążone w normalny sposób. Rozważ ustawienie budżetu nieco poniżej bezwzględnego limitu.

  • Ograniczone do projektu i usługi. Budżet limitu wydatków jest ograniczony do jednego projektu i jednej kwalifikującej się usługi w tym projekcie.

    • Nie możesz ustawić budżetu z limitem wydatków na poziomie całego Cloud Billingkonta ani na poziomie folderu, organizacji lub etykiety.

    • Nie możesz ustawić jednego budżetu z limitem wydatków, który obejmowałby wiele projektów lub usług.

    • Jeśli ustawisz limit wydatków dla usługi, będzie on obowiązywać w przypadku wszystkich sposobów korzystania z tej usługi w projekcie. Jeśli na przykład ustawisz budżet w przypadku Agent Platform Gemini API (formerly Vertex AI), będzie on obowiązywać również w przypadku korzystania z tego interfejsu API w projekcie za pomocą Firebase SQL Connect, ADK, Genkit itp. (nie tylko za pomocą Firebase AI Logic).

  • Miesięczny zakres czasowy Zakres czasu budżetu z limitem wydatków jest miesięczny i rozpoczyna się pierwszego dnia każdego miesiąca.

  • Usługa jest wznawiana automatycznie co miesiąc.

    • Jeśli nie zniesiesz egzekwowanego limitu wydatków, usługa pozostanie wstrzymana tylko w bieżącym miesiącu. Na początku następnego miesiąca egzekwowany limit wydatków automatycznie resetuje się do stanu Skonfigurowany z pierwotnym budżetem, a usługa zostaje wznowiona.

    • Jeśli w trakcie miesiąca zniesiesz wprowadzony limit wydatków i nie zmienisz budżetu, usługa będzie działać bez limitu wydatków do końca tego miesiąca, a limit wydatków zostanie automatycznie zresetowany do stanu Skonfigurowano z pierwotnym budżetem, a usługa zostanie wznowiona.

  • Nie obejmuje oszczędności i środków. Obliczenia kosztów w przypadku budżetu z limitem wydatków są oparte na kosztach brutto i nie uwzględniają oszczędności ani środków.

Jeśli masz bardziej zaawansowaną konfigurację płatności, więcej informacji o ograniczeniach budżetów z limitem wydatków znajdziesz w dokumentacji Google Cloud.