Questa pagina descrive come configurare e gestire i budget con limite di spesa quando il tuo progetto Firebase è nel piano tariffario Blaze.
I budget con limite di spesa sono disponibili per i seguenti servizi Firebase selezionati: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase e Firebase Extensions.
Vai alle istruzioni per configurare un limite di spesa
Informazioni sui budget
Puoi controllare i costi ed evitare sorprese in fattura creando budget per Google Cloud Billing. I budget sono importi monetari generali che prevedi di spendere ogni mese e possono essere budget solo con avvisi o budget con limite di spesa.
Budget solo avvisi
Se la spesa raggiunge le soglie impostate per il budget, Cloud Billing invia notifiche via email.
Tieni presente quanto segue:
Gli avvisi relativi al budget non mettono in pausa i servizi. Sono progettati per aiutarti a monitorare i costi e per avvisarti in modo che tu possa intervenire, se necessario. Ad esempio, potresti prendere in considerazione l'utilizzo delle notifiche relative al budget per disabilitare la fatturazione del progetto.
Quando esegui l'upgrade al piano tariffario Blaze nella console Firebase, ti viene chiesto automaticamente di configurare un budget solo per gli avvisi. Puoi anche configurare manualmente budget solo per avvisi nella console Google Cloud.
Budget con limite di spesa (questa pagina)
Se la spesa raggiunge le soglie impostate per il budget per un servizio specifico, Cloud Billing invia notifiche via email.
Se la spesa raggiunge il 100% del budget per quel servizio, Cloud Billing il servizio viene messo in pausa per il resto del mese.
Tieni presente quanto segue:
I budget con limiti di spesa sono disponibili solo per i seguenti servizi Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase e Firebase Extensions.
Puoi configurare manualmente i budget con limite di spesa nella console Firebase (come descritto in questa pagina) o nella console Google Cloud.
- Prima di impostare un budget con limite di spesa, esamina le informazioni importanti sui budget con limite di spesa più avanti in questa pagina.
Panoramica dei budget con limite di spesa
Prima di configurare un budget con limite di spesa, esamina le informazioni riportate in questa sezione, che include l'elenco dei servizi idonei e i possibili stati del limite di spesa. Ti consigliamo inoltre di esaminare i limiti dei budget con limite di spesa più avanti in questa pagina.
Puoi anche trovare un elenco di domande frequenti sui budget con limite di spesa nella documentazione di Google Cloud.
Servizi idonei
I budget con limiti di spesa possono essere configurati per i seguenti servizi Firebase:
- Firebase AI Logic: imposta limiti di accesso a Gemini Developer API o Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: imposta limiti per il servizio Cloud Run sottostante.
- Cloud Functions for Firebase: imposta limiti al servizio Cloud Run Functions sottostante.
- Firebase Extensions: imposta limiti al servizio Cloud Run Functions sottostante.
Stiamo lavorando per ampliare questo elenco di servizi idonei per i budget con limite di spesa, quindi controllalo periodicamente.
Stati del limite di spesa
Un limite di spesa può avere uno dei seguenti stati:
Configurato: Cloud Billing monitora attivamente la spesa del tuo progetto per un servizio specifico in base al budget con limite di spesa.
Applicato: la spesa del tuo progetto ha raggiunto il 100% del budget mensile per quel servizio, quindi Cloud Billing ha applicato il limite di spesa. Qualsiasi nuovo utilizzo del servizio per il resto del mese viene messo in pausa, a meno che il limite di spesa applicato non venga rimosso esplicitamente.
Rimosso: Cloud Billing il limite di spesa era stato applicato (e qualsiasi nuovo utilizzo del servizio applicabile era stato messo in pausa), ma il limite di spesa applicato è stato rimosso esplicitamente per ripristinare il servizio.
Nello stato Rimosso, il servizio viene eseguito senza limiti di spesa per il resto del mese, a meno che tu non riconfiguri o aumenti il limite. All'inizio del mese successivo, il budget del limite di spesa originale viene riattivato automaticamente.
Se non rimuovi un limite di spesa imposto, il servizio rimarrà in pausa solo per il mese corrente. Poi, all'inizio del mese successivo, il limite di spesa applicato verrà reimpostato automaticamente e il servizio riprenderà.
Configurare e gestire i limiti di spesa
Configura un budget con limite di spesa.
Configura un budget con limite di spesa in modo che Cloud Billing possa iniziare a monitorare attivamente la spesa del tuo progetto per un servizio specifico.Comprendere gli avvisi e l'applicazione del limite di spesa.
Se la spesa del progetto raggiunge determinate soglie del budget mensile per quel servizio, Cloud Billing invia email di avviso e applica il limite di spesa. L'applicazione significa che qualsiasi nuovo utilizzo del servizio viene messo in pausa per il resto del mese.(Facoltativo) Rimuovi un limite di spesa applicato (o aumenta il budget).
Se vuoi riprendere l'utilizzo di un servizio in pausa in quel mese (senza limiti o con un budget più elevato), devi rimuovere esplicitamente il limite di spesa imposto.
Autorizzazioni obbligatorie
Per configurare e gestire un budget con limite di spesa, devi disporre dell'accesso a livello amministrativo al progetto e al relativo account Cloud Billing collegato. Una delle seguenti opzioni ti concede le autorizzazioni richieste:
Opzione 1: Ruolo Amministratore account di fatturazione sull'account Cloud Billing collegato al progetto
Opzione 2: Ruolo Proprietario progetto nel progetto in cui vuoi configurare i budget con limite di spesa
Opzione 3: la seguente combinazione diCloud Billing ruoli IAM a livello di account e progetto:
Ruolo Gestore costi account di fatturazione nell'account Cloud Billing collegato al progetto
e
Ruolo Editor progetto nel progetto in cui vuoi configurare i budget con limite di spesa
Configurare un budget con limite di spesa
Affinché Cloud Billing inizi attivamente a monitorare la tua spesa per un servizio, devi configurare un budget con limite di spesa per quel servizio. Se il tuo progetto raggiunge determinate soglie di spesa per quel servizio, Cloud Billing invierà email di avviso e applicherà il limite di spesa.
Per configurare i budget con limite di spesa utilizzando la console Firebase:
Accedi al tuo progetto nella console Firebase, poi vai a
Impostazioni > Utilizzo e fatturazione > Pagina Dettagli e impostazioni.Vai alla scheda Limiti di spesa a livello di servizio.
Individua il servizio per cui vuoi impostare un limite, imposta l'importo del budget mensile e poi fai clic su Configura.
Un budget con limite di spesa è limitato a un singolo progetto e a un singolo servizio idoneo all'interno di quel progetto.
L'intervallo di tempo per un budget con limite di spesa è mensile, a partire dal primo giorno di ogni mese.
Tieni presente che puoi anche configurare i budget con limiti di spesa utilizzando la console Google Cloud.
Email di avviso e applicazione del limite di spesa
Dopo aver configurato un budget con limite di spesa, Cloud Billing monitorerà attivamente la spesa del tuo progetto per quel servizio. Invierà email di avviso e applicherà il limite di spesa in base alle seguenti soglie di spesa per il budget con limite di spesa del servizio.
50% e 80% del budget impostato:
- Cloud Billing invia email di avviso a tutti gli amministratori della fatturazione, ai proprietari del progetto e a qualsiasi "contatto essenziale" applicabile.
100% del budget impostato:
Cloud Billing applica il limite di spesa, il che significa che qualsiasi nuovo utilizzo del servizio applicabile verrà messo in pausa per il resto del mese a meno che tu non rimuova esplicitamente il limite di spesa applicato.
Cloud Billing invia un'altra email di avviso. Inoltre, la console Firebase e la console Google Cloud mostrano notifiche banner relative all'applicazione del limite di spesa e al servizio in pausa.
Impatto lato client e gestione degli errori
Quando un servizio viene messo in pausa a causa di un limite di spesa applicato, l'app lato client
inizierà a generare errori per quel servizio. Devi gestire queste eccezioni
in modo controllato nel codice dell'app (ad esempio, utilizzando i blocchi try-catch).
Rimuovere un limite di spesa applicato
Se viene attivato e applicato un limite di spesa, tutto il nuovo utilizzo del servizio applicabile viene messo in pausa per il resto del mese, a meno che tu non rimuova esplicitamente il limite di spesa applicato.
Ecco come rimuovere un limite di spesa forzato utilizzando la console Firebase:
Accedi al tuo progetto nella console Firebase, poi vai a
Impostazioni > Utilizzo e fatturazione > Pagina Dettagli e impostazioni.Vai alla scheda Limiti di spesa a livello di servizio.
Individua il servizio con un limite di spesa forzato e fai clic su Rimuovi.
Tieni presente che puoi anche rimuovere i limiti di spesa forzati utilizzando la Google Cloudconsole.
Aumentare un limite di spesa dopo l'applicazione
Se il limite di spesa è stato applicato e vuoi riprendere il servizio con un budget superiore per il resto del mese (ad esempio, aumentando il limite da 10 € a 20 €), non puoi modificare l'importo del budget mentre il limite è nello stato Applicato. Devi prima rimuovere il limite prima di impostarne uno più alto.
Ecco come ripristinare un servizio e aumentare il relativo limite di spesa:
Aumenta il limite di spesa:nella console Firebase o Google Cloud, individua il servizio applicato, quindi fai clic su Aumenta.
Il limite di spesa passerà allo stato In attesa durante la rimozione dell'applicazione.
Attendi il completamento dell'aumento:attendi qualche minuto e aggiorna la pagina finché lo stato del limite di spesa non viene visualizzato come Aumentato.
Il servizio verrà ripristinato. A seconda del servizio, l'operazione può richiedere fino a un'ora.
Aggiorna l'importo del budget:modifica il budget del limite di spesa inserendo il nuovo importo del budget mensile più elevato. Salva le modifiche.
Considerazioni importanti quando si aumenta un limite:
Legato alla spesa totale del mese corrente:il nuovo importo del budget è ancora legato alla spesa totale accumulata per il mese corrente, inclusi eventuali superamenti dei costi maturati durante i ritardi nella generazione dei report prima dell'applicazione del limite.
Imposta un budget superiore alla spesa del mese corrente:assicurati che il nuovo budget sia superiore a quanto hai già speso questo mese (inclusi gli addebiti in eccesso). In caso contrario, il limite verrà attivato e il servizio verrà messo in pausa di nuovo immediatamente.
Calcolo del budget rimanente:il budget rimanente per il mese è l'importo della nuova soglia meno la spesa totale finora. Ad esempio:
Hai impostato un limite di spesa di 10 € il giorno Cloud Functions for Firebase.
La spesa raggiunge i 10 $ (più 1 $di superamento della quota di utilizzo durante il ritardo nella generazione dei report, per un totale di 11 $). Il limite viene applicato e le funzioni vengono messe in pausa.
Confermi che il traffico è legittimo, quindi rimuovi il limite e attendi che lo stato mostri Rimosso.
Aggiorni il limite di spesa a 20 $. Quando salvi questa modifica, il limite di spesa viene reimpostato sullo stato Configurato.
Le tue funzioni continuano a essere eseguite con il nuovo limite di 20 $, con circa 9 $di budget rimanenti per il mese (limite di 20 $ meno 11 $ già accumulati).
Il mese successivo, il budget del limite di spesa manterrà la soglia di 20 $.
Limitazioni dei budget con limite di spesa
Di seguito sono riportate importanti limitazioni da comprendere in merito ai budget con limite di spesa:
I budget con limiti di spesa non sono "limiti massimi". A causa della latenza nella generazione dei report sull'utilizzo, l'applicazione del limite di spesa non è istantanea e può essere ritardata di diversi minuti. Eventuali costi aggiuntivi sostenuti durante questo ritardo verranno fatturati normalmente. Valuta la possibilità di impostare il budget leggermente al di sotto del limite assoluto.
Con ambito a livello di progetto e servizio. Un budget con limite di spesa è limitato a un singolo progetto e a un singolo servizio idoneo all'interno di quel progetto.
Non puoi impostare un budget con limite di spesa a livello di intero account Cloud Billing o a livello di cartella, organizzazione o etichetta.
Non puoi impostare un unico budget con limite di spesa che copra più progetti o più servizi.
Quando imposti un budget con limite di spesa per un servizio, questo viene applicato a tutti i modi in cui potresti interagire con il servizio nel progetto. Ad esempio, se imposti un budget su Agent Platform Gemini API (formerly Vertex AI), questo si applica anche a qualsiasi utilizzo dell'API nel progetto tramite Firebase SQL Connect, ADK, Genkit e così via (non solo l'utilizzo tramite Firebase AI Logic).
Intervallo di tempo mensile. L'intervallo di tempo di un budget con limite di spesa è mensile e inizia il primo giorno di ogni mese.
Il servizio riprende automaticamente ogni mese.
Se non rimuovi un limite di spesa imposto, il servizio rimarrà in pausa solo per il mese corrente. All'inizio del mese successivo, il limite di spesa applicato viene reimpostato automaticamente sullo stato Configurato con il budget originale e il servizio riprende.
Se rimuovi un limite di spesa applicato durante il mese e non modifichi il budget, il servizio viene eseguito senza un limite di spesa per il resto del mese e il limite di spesa viene reimpostato automaticamente sullo stato Configurato con il budget originale e il servizio riprende.
Non include risparmi e crediti. I calcoli dei costi per un budget con limite di spesa si basano sui costi lordi e non includono risparmi e crediti.
Se hai una configurazione di fatturazione più avanzata, puoi trovare maggiori dettagli sui limiti dei budget con limite di spesa nella documentazione di Google Cloud.