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

Wersja testowa: budżety z limitem wydatków są dostępne w wersji testowej, co oznacza, że nie podlegają żadnej gwarancji jakości usług ani żadnym zasadom wycofywania i mogą ulec zmianie w sposób niezapewniający zgodności wstecznej.

Na tej stronie dowiesz się, jak skonfigurować budżety z limitem wydatków i nimi zarządzać, gdy projekt w Firebase jest objęty abonamentem Blaze.

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

Ważne: limity wydatków nie są „sztywnymi limitami”. 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 koszty przekroczenia budżetu poniesione w tym okresie zostaną rozliczone w normalny sposób.
W związku z tym należy ustawić budżet nieco poniżej bezwzględnego limitu, a limity wydatków traktować jako jedno z narzędzi, które mogą pomóc w zarządzaniu kosztami i ograniczeniu wpływu dużych, nieoczekiwanych rachunków. Dowiedz się więcej o dodatkowych opcjach alertów i logiki.

Przejdź do instrukcji konfigurowania limitu wydatków

Informacje o budżetach

Możesz kontrolować koszty i uniknąć niespodzianek na rachunku, tworząc budżety dla Google Cloud Billing. Budżety to ogólne kwoty, 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:

  • Alerty dotyczące budżetu nie powodują wstrzymania usług. Ich zadaniem jest pomóc Ci w monitorowaniu kosztów i ostrzeganiu, aby w razie potrzeby można było podjąć odpowiednie działania. Możesz na przykład użyć powiadomień o budżecie, aby wyłączyć płatności w projekcie.

  • Gdy przejdziesz na abonament Blaze w konsoli Firebase, automatycznie pojawi się prośba o skonfigurowanie budżetu tylko z alertami. Możesz też ręcznie skonfigurować budżety tylko z alertami w konsoli Google Cloud.

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

• Jeśli wydatki osiągną określone progi budżetu na konkretną usługę, Cloud Billing wyśle e-maile z powiadomieniami.

• 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:

  • Budżety z limitami 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 (zgodnie z opisem na tej stronie) lub w konsoli Google Cloud.

  • Zanim skonfigurujesz budżet z limitem wydatków, zapoznaj się z ważnymi informacjami o budżetach z limitem wydatków, które znajdziesz poniżej na tej stronie.

Wszystkie projekty Firebase są w rzeczywistości projektami Google Cloud za kulisami, co oznacza, że Firebase i Google Cloud korzystają z tych samych informacji rozliczeniowych, a ten sam projekt możesz wyświetlać zarówno w konsoli Firebase, jak i 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, które obejmują listę kwalifikujących się usług i możliwe stany limitu wydatków. Zalecamy też zapoznanie się z ograniczeniami budżetów z limitem wydatków, które opisujemy 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

Limity wydatków można ustawić 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 Cloud Run.
• Cloud Functions for Firebase: ustaw limity w usłudze funkcji Cloud Run.
• Firebase Extensions: ustaw limity w usłudze funkcji Cloud Run.

Pracujemy nad dodaniem do tej listy kolejnych usług, które kwalifikują się do korzystania z budżetów z limitem wydatków, więc sprawdzaj ją co jakiś czas.

Uwaga: gdy ustawisz budżet z limitem wydatków dla jednej z usług podstawowych wymienionych powyżej, będzie on obowiązywać na poziomie projektu i we wszystkich sposobach interakcji z usługą w projekcie. Jeśli na przykład ustawisz budżet dla 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).

Stany limitu wydatków

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

• Skonfigurowano: Cloud Billing aktywnie monitoruje wydatki w Twoim projekcie na konkretną usługę na podstawie budżetu z limitem wydatków.

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

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

  W stanie Zniesiony usługa działa bez limitu wydatków przez pozostałą część miesiąca, chyba że zmienisz konfigurację lub zwiększysz limit. Na początku następnego miesiąca pierwotny budżet z limitem wydatków zostanie automatycznie ponownie włączony.

Uwaga: zmiana dowolnej konfiguracji limitu wydatków (nawet zmiana nazwy budżetu w konsoli Google Cloud) powoduje przywrócenie stanu Skonfigurowano. Jeśli Twoje miesięczne wydatki osiągnęły już próg budżetu lub go przekroczyły, limit zostanie natychmiast aktywowany i wprowadzony.

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

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

Uwaga: zanim skonfigurujesz budżet z limitem wydatków, zapoznaj się z omówieniem budżetów z limitem wydatków, które znajdziesz powyżej na tej stronie.

1. Skonfiguruj budżet z limitem wydatków.
   Skonfiguruj budżet z limitem wydatków, aby usługa Cloud Billing mogła zacząć aktywnie monitorować wydatki na konkretną usługę w Twoim projekcie.

2. Alerty i egzekwowanie limitu wydatków
   Jeśli wydatki na projekt osiągną określone progi budżetu miesięcznego 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 możesz usunąć 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 z wyższym budżetem), musisz wyraźnie znieść wymuszony 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ć na jeden z tych sposobów:

• Opcja 1: rola administratora konta rozliczeniowego na koncie Cloud Billing połączonym z projektem

• Opcja 2. Rola właściciela projektu w projekcie, w którym chcesz skonfigurować budżety z limitem wydatków.

• Opcja 3. Ta kombinacja ról Uprawnień na poziomie konta Cloud Billing i na poziomie projektu:

  • rola Menedżer kosztów konta rozliczeniowego na koncie Cloud Billing połączonym z projektem,

    i

  • Rola edytującego projekt w projekcie, w którym chcesz skonfigurować budżety z limitem wydatków.

Konfigurowanie budżetu z limitem wydatków

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

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

1. Otwórz swój projekt w konsoli Firebase, a następnie przejdź na stronę 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.

Uwaga: budżety z limitami wydatków nie są „sztywnymi limitami”. Ze względu na opóźnienia w raportowaniu wykorzystania egzekwowanie limitu wydatków nie jest natychmiastowe. Wszelkie dodatkowe koszty poniesione w tym czasie zostaną naliczone w normalny sposób. Rozważ ustawienie budżetu nieco poniżej limitu bezwzględnego.

Pamiętaj, że możesz też skonfigurować budżety z limitami wydatków za pomocą 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 dla budżetu z limitem wydatków tej usługi.

• 50% i 80% ustawionego budżetu:

  • Cloud Billing wysyła e-maile z ostrzeżeniami do wszystkich administratorów rozliczeń, właścicieli projektów i odpowiednich „niezbędnych kontaktów”.

• 100% ustalonego budżetu:

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

  • Cloud Billing wysyła kolejnego e-maila z alertem. W konsoli Firebase i konsoli Google Cloud wyświetlane są też powiadomienia na banerze o egzekwowaniu 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. Te wyjątki należy odpowiednio obsłużyć w kodzie aplikacji (np. za pomocą bloków try-catch).

Znoszenie wyegzekwowanego limitu wydatków

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

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

1. Otwórz swój projekt w konsoli Firebase, a następnie przejdź na stronę 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 egzekwowanym limitem wydatków, a następnie kliknij Znieś.

Pamiętaj o tych kwestiach dotyczących zniesienia limitu wydatków:

• Możliwe opóźnienie wznowienia działania usługi: po zniesieniu wymuszonego limitu wydatków pełne wznowienie działania niektórych usług może potrwać do godziny.
• Brak limitu do końca miesiąca: jeśli zniesiesz obowiązujący limit wydatków i nie wprowadzisz żadnych innych zmian, usługa będzie działać bez limitu wydatków do końca danego miesiąca. Na początku następnego miesiąca limit wydatków zostanie automatycznie zresetowany do stanu Skonfigurowany z pierwotnym budżetem, a usługa zostanie wznowiona.
• 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 limit wydatków zostanie automatycznie zresetowany do stanu Skonfigurowany z pierwotnym budżetem, a usługa zostanie wznowiona.

Pamiętaj, że możesz też usunąć wymuszone limity wydatków za pomocą konsoli Google Cloud.

Zwiększanie limitu wydatków po jego wyegzekwowaniu

Jeśli limit wydatków jest egzekwowany i chcesz wznowić usługę z wyższym budżetem na pozostałą część miesiąca (np. zwiększyć limit z 10 USD do 20 USD), nie możesz edytować kwoty budżetu, gdy limit jest w stanie Egzekwowany. Zanim ustawisz wyższy limit, musisz usunąć ograniczenie.

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

1. Znieść limit wydatków: w konsoli Firebase lub Google Cloud znajdź usługę, której dotyczy egzekwowanie, a następnie kliknij Znieś.

   Limit wydatków przejdzie w stan oczekiwania, gdy egzekwowanie zostanie usunięte.

2. Poczekaj na zniesienie limitu: odczekaj kilka minut i odśwież stronę, aż stan limitu wydatków zmieni się na Zniesiony.

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

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

Ważne kwestie dotyczące podnoszenia limitu:

• Powiązanie z łącznymi wydatkami w bieżącym miesiącu: nowa kwota budżetu jest nadal powiązana z łącznymi wydatkami w bieżącym miesiącu, w tym z nadmiernymi kosztami poniesionymi podczas opóźnień w raportowaniu, zanim limit został wprowadzony.

• Ustaw budżet wyższy niż wydatki w bieżącym miesiącu: upewnij się, że nowy budżet jest wyższy niż kwota wydana w tym miesiącu (wliczając w to nadwyżki). W przeciwnym razie limit zostanie aktywowany i natychmiast ponownie wstrzyma usługę.

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

  1. Cloud Functions for Firebase ustawiono limit wydatków w wysokości 10 USD.

  2. Wydatki osiągają 10 USD (plus 1 USD nadwyżki podczas opóźnienia w raportowaniu, co daje łącznie 11 USD). Limit zostanie wyegzekwowany, a funkcje zostaną wstrzymane.

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

  4. Zaktualizujesz limit wydatków do 20 zł. Gdy zapiszesz tę zmianę, limit wydatków zostanie przywrócony do stanu Skonfigurowany.

  5. Funkcje będą nadal działać w ramach nowego limitu 20 USD, a do wykorzystania w danym miesiącu pozostanie około 9 USD (limit 20 USD minus 11 USD już naliczone).

  6. W następnym miesiącu budżet z limitem wydatków utrzyma próg 20 zł.

Ograniczenia budżetów z limitem wydatków

Oto ważne ograniczenia dotyczące 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 dodatkowe koszty poniesione w tym okresie opóźnienia zostaną rozliczone w normalny sposób. Rozważ ustawienie budżetu nieco poniżej bezwzględnego limitu.

• Zakres 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 konta Cloud Billing 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.

  • Gdy ustawisz budżet z limitem wydatków dla usługi, będzie on obowiązywać we wszystkich sposobach interakcji z usługą w projekcie. Jeśli na przykład ustawisz budżet na 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 czasu budżetu z limitem wydatków jest miesięczny i rozpoczyna się pierwszego dnia każdego miesiąca.

• Usługa jest automatycznie wznawiana 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 powraca do stanu Skonfigurowany z pierwotnym budżetem, a usługa zostaje wznowiona.

  • Jeśli w ciągu miesiąca zniesiesz wymuszony limit wydatków i nie zmienisz budżetu, usługa będzie działać bez limitu wydatków przez pozostałą część tego miesiąca, a limit wydatków zostanie automatycznie zresetowany do stanu Skonfigurowany z pierwotnym budżetem, a usługa zostanie wznowiona.

• Nie obejmuje oszczędności ani ś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.