Come funziona il rilevamento dei picchi di utilizzo
Ultimo aggiornamento: November 2026
Cosa misura
- Utilizzo, non costo. FireShield legge l'utilizzo di ogni servizio monitorato da Google Cloud Monitoring: letture di documenti, invocazioni, dati scaricati, token e così via.
- Coglie ciò che i budget non vedono: Google segnala la spesa con un ritardo da 15 minuti a diverse ore, mentre le metriche di utilizzo arrivano in pochi minuti.
- Fa parte del piano Pro (controllo ogni 5 minuti).
- Servizi che puoi monitorare: Cloud Firestore (letture, scritture ed eliminazioni di documenti), Cloud Functions (invocazioni), Cloud Functions e Cloud Run (tempo di calcolo), Cloud Storage (operazioni, dati scaricati e dati caricati), Realtime Database (dati scaricati), SQL Connect (operazioni), Cloud SQL (byte inviati e transazioni), Hosting (trasferimento dati), Vertex AI e Firebase AI Logic (token), Gemini API (richieste). Una chiave Gemini API creata in Google AI Studio spesso si trova in un progetto Google Cloud a sé, quindi collega quel progetto per monitorarla.
Quando scatta un picco
- Il normale è l'ora media degli ultimi 7 giorni. Un'ora senza utilizzo conta come zero, quindi non c'è un periodo di apprendimento.
- Una regola scatta quando gli ultimi 60 minuti raggiungono il moltiplicatore scelto (per esempio ×10 il normale) e superano il normale di almeno l'aumento minimo scelto.
- L'aumento minimo è facoltativo. Evita che un moltiplicatore alto scatti quando l'utilizzo normale è molto basso: se il normale è 3 all'ora, ×10 fa solo 30.
- Un servizio senza utilizzo per tutta la settimana che all'improvviso riceve traffico conta come un picco da zero, purché superi l'aumento minimo.
- Non c'è nulla da aprire o chiudere: ogni controllo (ogni 5 minuti) che soddisfa ancora la regola esegue di nuovo le sue azioni, finché l'utilizzo non scende.
Le stesse azioni vengono eseguite a ogni controllo
Finché l'utilizzo resta sopra la regola, ogni controllo esegue di nuovo tutte le sue azioni: le email e i messaggi Slack e Telegram si ripetono ogni 5 minuti finché l'utilizzo non scende. Il tuo endpoint di Soft Kill riceverà la stessa chiamata più volte di seguito, quindi rendilo idempotente: attivare la modalità ridotta quando è già attiva non deve causare problemi. Vedi Webhook Soft Kill · guida all'integrazione.
Come si configura
- Apri un progetto nella dashboard. Assegna all'account di servizio di FireShield il ruolo di sola lettura Monitoring Viewer su quel progetto, dalla console Google Cloud o con il comando gcloud mostrato dalla dashboard, poi attiva il rilevamento. Si fa una volta per progetto, e FireShield non riceve nient'altro.
- Scegli un servizio da monitorare. Ogni servizio monitorato ha una regola: il suo moltiplicatore, il suo aumento minimo e le sue azioni.
- Ogni servizio monitorato mostra l'utilizzo orario degli ultimi 7 giorni, con il normale come linea tratteggiata, e i suoi ultimi picchi accanto al grafico.
- Disattivare il rilevamento interrompe i controlli per quel progetto.
Cosa succede quando scatta
- Vengono eseguite le azioni della regola: un'email, un messaggio Slack o Telegram, un webhook di Soft Kill o un Hard Kill che scollega la fatturazione del progetto.
- Un Soft Kill inviato da un picco contiene il servizio, l'utilizzo dell'ultima ora e il livello normale, così il tuo codice può distinguerlo da un avviso di budget. Vedi Webhook Soft Kill · guida all'integrazione.
- Un Hard Kill ferma tutto ciò che il progetto esegue. Vedi Cos'è un Hard Kill.
Nessuna tregua dopo un Hard Kill per un picco
Mentre un progetto è fermo, FireShield non lo controlla. Quando premi Reactivate, il controllo successivo (5 minuti dopo) rilegge gli ultimi 60 minuti, e se riattivi entro circa un'ora dal distacco, il picco può essere ancora in quella finestra: l'Hard Kill viene eseguito di nuovo. Prima di riattivare, risolvi la causa, poi aspetta che sia passata un'ora dal distacco, oppure modifica la regola (togli l'Hard Kill o alza il moltiplicatore) e ripristinala quando l'utilizzo torna normale. L'Hard Kill di un budget è diverso: non scatta di nuovo nello stesso mese con lo stesso importo di budget.
Buono a sapersi
- Vede l'utilizzo, non il denaro: una regola non distingue un picco economico da uno costoso. Esempio: ×10 il normale sul trasferimento dati di Hosting o sui dati scaricati da Cloud Storage di solito significa qualche GB in più, da pochi centesimi a pochi dollari, e può essere traffico legittimo. ×10 sui token di Firebase AI Logic o sulle scritture Firestore causate da un loop può costare decine o centinaia di dollari in poche ore. Usa quindi moltiplicatori più bassi (con un aumento minimo) dove ogni unità è costosa, e più alti dove i picchi costano poco e il traffico varia molto.
- I dati di Cloud Monitoring arrivano con qualche minuto di ritardo, quindi gli ultimi minuti di un picco compaiono al controllo successivo.
- Affianca il tuo budget, non lo sostituisce. Mantieni le soglie di budget su ogni progetto: sono quelle che misurano il denaro.
