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ę.

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 wznawiana automatycznie co miesiąc. Jeśli nie zniesiesz wymuszonego limitu wydatków, usługa pozostanie wstrzymana tylko w bieżącym miesiącu. Następnie na początku następnego miesiąca egzekwowany limit wydatków zostanie automatycznie zniesiony, 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 Google Cloud dokumentacji.