Configurare i limiti di spesa per i servizi Firebase


In questa pagina viene descritto 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 per soli avvisi o budget con limite di spesa.

Budget per soli avvisi

  • Se la spesa raggiunge le soglie impostate per il budget, Cloud Billing invia notifiche via email.

  • Tieni presente quanto segue:

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 mette in pausa il servizio 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.

Panoramica dei budget con limite di spesa

Prima di impostare un budget con limite di spesa, consulta le informazioni in questa sezione, che include l'elenco dei servizi idonei e dei possibili stati del limite di spesa. Ti consigliamo inoltre di esaminare le limitazioni 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 i limiti per il servizio Cloud Run sottostante.
  • Cloud Functions for Firebase: imposta i limiti per il servizio Cloud Run Functions sottostante.
  • Firebase Extensions: imposta i limiti per il servizio Cloud Run Functions sottostante.

Stiamo lavorando per aggiungere altri servizi idonei per i budget con limite di spesa, quindi controlla periodicamente questo elenco.

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 progetto ha raggiunto il 100% del budget mensile impostato per quel servizio, pertanto 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 aveva applicato il limite di spesa (e messo in pausa qualsiasi nuovo utilizzo del servizio applicabile), 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 applicato, 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 verrà ripreso.

Configura e gestisci i limiti di spesa

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

  2. Scopri di più sugli avvisi e sull'applicazione dei limiti di spesa.
    Se la spesa del tuo progetto raggiunge determinate soglie del budget mensile per quel servizio, Cloud Billing invia email di avviso e applica il limite di spesa. Applicazione significa che qualsiasi nuovo utilizzo di quel servizio viene messo in pausa per il resto del mese.

  3. Facoltativamente, rimuovi un limite di spesa applicato (o aumenta il budget).
    Se vuoi riprendere l'utilizzo di un servizio in pausa per quel mese (senza limiti o con un budget più elevato), devi rimuovere esplicitamente il limite di spesa applicato.

Autorizzazioni obbligatorie

Per configurare e gestire un budget con limite di spesa, devi disporre dell'accesso a livello di amministratore al progetto e al relativo account Cloud Billing collegato. Una delle seguenti opzioni ti concede le autorizzazioni richieste:

Configura un budget con limite di spesa

Affinché Cloud Billing inizi a monitorare attivamente 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.

Ecco come configurare i budget con limite di spesa utilizzando la console Firebase:

  1. Accedi al tuo progetto nella console Firebase, quindi vai alla pagina Impostazioni > Utilizzo e fatturazione > Dettagli e impostazioni.

  2. Vai alla scheda Limiti di spesa a livello di servizio.

  3. 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 ha come ambito un singolo progetto e 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 del limite di spesa del servizio.

  • 50% e 80% del budget impostato:

    • Cloud Billing invia email di avviso a tutti gli amministratori della fatturazione, ai Project Owner e a tutti i "contatti essenziali" applicabili.
  • 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 corretto nel codice dell'app (ad esempio, utilizzando i blocchi try-catch).

Rimuovi un limite di spesa applicato

Se viene attivato e applicato un limite di spesa, tutti i nuovi utilizzi del servizio applicabile vengono messi 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 applicato utilizzando la console Firebase:

  1. Accedi al tuo progetto nella console Firebase, quindi vai alla pagina Impostazioni > Utilizzo e fatturazione > Dettagli e impostazioni.

  2. Vai alla scheda Limiti di spesa a livello di servizio.

  3. Individua il servizio con un limite di spesa applicato, quindi fai clic su Rimuovi.

Tieni presente che puoi anche rimuovere i limiti di spesa applicati utilizzando la console Google Cloud.

Aumenta un limite di spesa dopo l'applicazione

Se il limite di spesa è applicato e vuoi riprendere il servizio con un budget più elevato 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:

  1. Rimuovi il limite di spesa: nella console Firebase o Google Cloud, individua il servizio applicato, quindi fai clic su Rimuovi.

    Il limite di spesa entrerà in uno stato di attesa mentre l'applicazione viene rimossa.

  2. Attendi il completamento della rimozione: attendi qualche minuto e aggiorna la pagina finché lo stato del limite di spesa non diventa Rimosso.

    Il servizio verrà ripristinato. A seconda del servizio, l'operazione può richiedere fino a un'ora.

  3. Aggiorna l'importo del budget: modifica il budget con limite di spesa inserendo il nuovo importo del budget mensile, che deve essere superiore. Salva le modifiche.

Considerazioni importanti per l'aumento di un limite:

  • Vincolato alla spesa totale del mese corrente: il nuovo importo del budget è ancora vincolato alla spesa totale accumulata per il mese corrente, inclusi eventuali superamenti dei costi sostenuti durante i ritardi nei 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 overflow). In caso contrario, il limite verrà attivato e il servizio verrà nuovamente messo in pausa immediatamente.

  • Calcolo del budget rimanente: il budget rimanente per il mese è l'importo della nuova soglia meno la spesa totale fino a quel momento. Ad esempio:

    1. Hai impostato un limite di spesa di 10 $su Cloud Functions for Firebase.

    2. La tua spesa raggiunge i 10 $ (più un superamento di 1 $durante il ritardo dei report, per un totale di 11 $). Il limite viene applicato, mettendo in pausa le funzioni.

    3. Confermi che il traffico è legittimo, quindi rimuovi il limite e attendi che lo stato mostri Rimosso.

    4. Aggiorni il limite di spesa a 20 $. Quando salvi questa modifica, il limite di spesa viene reimpostato sullo stato Configurato.

    5. Le tue funzioni continuano a essere eseguite con il nuovo limite di 20 $, con un budget rimanente di circa 9 $per il mese (limite di 20 $ meno 11 $ già maturati).

    6. 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 alcune limitazioni importanti da comprendere in merito ai budget con limite di spesa:

  • I budget con limiti di spesa non sono "limiti massimi". A causa della latenza nei report sull'utilizzo, l'applicazione del limite di spesa non è istantanea e può essere ritardata di diversi minuti. Eventuali eccedenze di costo sostenute durante questo ritardo verranno fatturate 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 si applica 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 di quell'API nel progetto tramite Firebase SQL Connect, ADK, Genkit e così via (non solo all'utilizzo tramite Firebase AI Logic).

  • Intervallo di tempo mensile. L'intervallo di tempo di un budget con limite di spesa è mensile, a partire dal primo giorno di ogni mese.

  • Il servizio riprende automaticamente ogni mese.

    • Se non rimuovi un limite di spesa applicato, 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 viene ripristinato.

  • 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 sulle limitazioni dei budget con limite di spesa nella documentazione di Google Cloud.