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.

Budżety z limitem wydatków są dostępne w przypadku tych wybranych usług Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for FirebaseFirebase Extensions.

 Przejdź do instrukcji konfigurowania limitu wydatków

Informacje o budżetach

Tworzenie budżetów na Google Cloud Billing pozwala kontrolować koszty i uniknąć niespodzianek na rachunku. 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

  • Jeśli wydatki osiągną ustawione progi budżetu, Cloud Billing wyśle e-maile z powiadomieniami.

  • Pamiętaj:

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

  • Jeśli wydatki osiągną ustawione progi budżetu dla konkretnej usługi, Cloud Billing wyśle e-maile z powiadomieniami.

  • Jeśli wydatki osiągną 100% budżetu na daną usługę, Cloud Billing wstrzymamy 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 FirebaseFirebase 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ą usług, które kwalifikują się do tej funkcji, oraz z możliwymi stanami 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 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 tę listę.

Stany limitu wydatków

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

  • Skonfigurowano: usługa Cloud Billing aktywnie monitoruje wydatki projektu na konkretną usługę na podstawie budżetu limitu wydatków.
  • Egzekwowany: wydatki w 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ę.
zniesiesz go wyraźnie.

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. Dowiedz się więcej o alertach i egzekwowaniu limitu wydatków.
    Jeśli wydatki projektu osiągną określone progi miesięcznego budżetu na daną 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 znieś wprowadzony limit wydatków.
    Jeśli chcesz wznowić korzystanie z wstrzymanej usługi w danym miesiącu, musisz wyraźnie znieść wprowadzony 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 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 Billingwyś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 potem 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 z limitem 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 jest miesięczny i rozpoczyna się pierwszego dnia każdego miesiąca.

Pamiętaj, że budżety z limitami wydatków możesz też skonfigurować w konsoli Google Cloud.

E-maile z alertami i egzekwowanie limitu wydatków

Po skonfigurowaniu budżetu z limitem wydatków 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 na tę usługę.

  • 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 podstawowych”.
  • 100% ustawionego budżetu:

    • 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 FirebaseGoogle 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, wszystkie nowe przypadki użycia danej usługi zostaną wstrzymane na pozostałą część miesiąca, chyba że wyraźnie zniesiesz wyegzekwowany limit wydatków.

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

  1. Otwórz projekt w Firebase konsoli, a potem 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 Zwiększ.

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

Ograniczenia budżetów z limitem wydatków

Oto ważne ograniczenia budżetów z limitem wydatków, o których warto pamiętać:

  • Budżety limitów 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, będą obciążane w normalny sposób. Rozważ ustawienie budżetu nieco poniżej bezwzględnego limitu.

  • Ograniczone do projektu i usługi. Budżet z limitem 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 wiele usług.

    • Jeśli ustawisz budżet z limitem 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 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 czasu Zakres czasowy budżetu z limitem wydatków jest miesięczny i rozpoczyna się pierwszego dnia każdego miesiąca.

  • Usługa jest domyślnie wznawiana co miesiąc. Jeśli nie zniesiesz wymuszonego limitu wydatków, usługa pozostanie wstrzymana tylko w bieżącym miesiącu.

    • Domyślnie na początku następnego miesiąca egzekwowany limit wydatków zostanie automatycznie zniesiony, a usługa zostanie wznowiona.

    • Możesz jednak dostosować ustawienia budżetu limitu wydatków tak, aby limit wydatków był egzekwowany (a usługa pozostawała wstrzymana) bezterminowo, dopóki nie zniesiesz egzekwowanego limitu wydatków.

    Jeśli nie zniesiesz egzekwowanego limitu wydatków, usługa pozostanie wstrzymana w bieżącym miesiącu, ale automatycznie wznowi działanie na początku następnego miesiąca. Możesz jednak dostosować ustawienia budżetu limitu wydatków, aby limit wydatków był egzekwowany (a usługa pozostawała wstrzymana) bezterminowo, dopóki nie zniesiesz go ręcznie.

  • 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 Google Cloud dokumentacji.