Per aiutarti a pianificare la capacità ed evitare interruzioni del servizio, Cloud Logging applica quote e limiti di sistema alle richieste API, allo spazio di archiviazione e alle configurazioni delle risorse. Puoi richiedere aumenti per la maggior parte delle quote, ma i limiti di sistema sono fissi e non possono essere modificati.
Quote e limiti di utilizzo di Logging
La tabella seguente elenca le quote e i limiti che si applicano all'utilizzo di Cloud Logging. In generale, puoi richiedere un aumento di una quota. Tuttavia, i limiti non possono essere modificati.
Alcune voci sono elencate come per progetto, ma la nota indica che la voce si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchica. Ad esempio, se hai più progetti Google Cloud in un'organizzazione, puoi configurare fino a 200 sink per ogni progetto Google Cloud ; per la stessa organizzazione, puoi anche configurare fino a 200 sink a livello di organizzazione.
| Categoria | Valore massimo del limite o valore della quota iniziale di |
Note |
|---|---|---|
Dimensioni di un
LogEntry |
256 KiB | Questo limite è approssimativo e si basa sulle dimensioni dei dati interni, non sulle dimensioni effettive della richiesta API REST. Non può essere aumentata. |
| Dimensioni di una voce di log di controllo | 512 KiB | Non può essere aumentata. |
| Numero di etichette | 64 per LogEntry |
Non può essere aumentata. |
Lunghezza di una chiave di etichetta LogEntry |
512 B | Cloud Logging tronca le chiavi delle etichette di dimensioni eccessive quando viene scritta la voce di log associata. Non può essere aumentata. |
Lunghezza di un valore etichetta LogEntry |
64 KiB | Cloud Logging tronca i valori delle etichette di dimensioni eccessive quando viene scritta la voce di log associata. Non può essere aumentata. |
| Lunghezza di una query nel linguaggio di query di Logging | 20.000 caratteri | Non può essere aumentata. |
| Fanout delle query | 200 bucket | Questo limite corrisponde al numero massimo di bucket che possono contenere voci di log per una risorsa. Per saperne di più, consulta La query restituisce un errore. Non può essere aumentata. Per motivi di prestazioni, riduci al minimo il numero di bucket di log e creali in un'unica regione. Se devi eseguire spesso query sulle voci di log provenienti da risorse diverse, valuta la possibilità di instradare le voci di log a un numero ridotto di bucket di log centralizzati. |
| Numero di sink | 200 per progetto Google Cloud | Può essere aumentato a 4000. Questa quota si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchica. |
| Lunghezza di un filtro di inclusione del sink | 20.000 caratteri | Non può essere aumentata. |
| Lunghezza di un filtro di esclusione del sink | 20.000 caratteri | Non può essere aumentata. |
| Numero di filtri di esclusione | 50 per sink | Non può essere aumentata. Se hai bisogno di più di 50 filtri di esclusione, perfeziona il filtro di inclusione. |
| Numero di bucket di log | 100 per progetto Google Cloud | Può essere aumentato a 2500. Questa quota indica il numero massimo di bucket che potrebbero contenere voci di log per una risorsa e include i bucket per cui è in attesa l'eliminazione. Questa quota si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchica. Se aumenti il numero massimo di bucket di log, l'esperienza utente potrebbe peggiorare perché l'ambito di log predefinito non può includere tutti i bucket di log di un progetto. |
| Numero di campi indicizzati personalizzati | 20 per bucket di log | Non può essere aumentata. Cloud Logging supporta l'indicizzazione integrale. Pertanto, non consigliamo di definire l'indicizzazione personalizzata. |
| Numero di visualizzazioni log | 30 per bucket di log | Può essere aumentato a 1000 visualizzazioni log su un singolo bucket di log. Se aumenti il numero massimo di visualizzazioni di log, l'esperienza utente potrebbe peggiorare perché l'ambito dei log predefinito non può includere tutte le visualizzazioni di log in un progetto. |
| Timestamp meno recente che può essere archiviato nei bucket di log | Determinato dal periodo di conservazione del bucket di log. | Per un bucket di log personalizzato con il periodo di conservazione predefinito, questo valore è di 30 giorni nel passato. L'API Logging accetta voci di log con timestamp precedenti e queste voci di log vengono indirizzate alle destinazioni sink. Tuttavia, se le voci di log con timestamp meno recenti vengono indirizzate a un bucket di log, non vengono archiviate. |
| Timestamp futuro che può essere archiviato nei bucket di log | Fino a 1 giorno nel futuro | L'API Logging rifiuta le voci con timestamp successivi di oltre un giorno e restituisce un errore INVALID_ARGUMENT. Non può essere aumentata. |
| Numero di ambiti di log per risorsa | 100 | Può essere aumentato a 10.000. |
| Numero di visualizzazioni di log e progetti inclusi in un ambito di log | 100 | Ti consigliamo di elencare le visualizzazioni dei log anziché i progetti in un ambito dei log, se possibile. La visualizzazione dell'elenco delle visualizzazioni dei log riduce il tempo di query e aumenta la chiarezza sulle voci di log su cui viene eseguita la query. |
| Numero di progetti inclusi in un ambito di log | 5 | Ti consigliamo di elencare le visualizzazioni dei log nell'ambito dei log anziché i progetti, se possibile. Le visualizzazioni di log possono trovarsi in progetti diversi. |
| Numero massimo di viste di analisi per progetto Google Cloud | 100 | Non può essere aumentata. Questa funzionalità è in Anteprima pubblica. |
| Per progetto Google Cloud , il numero massimo di viste di analisi per regione | 50 | Non può essere aumentata. Questa funzionalità è in Anteprima pubblica. |
| Per progetto Google Cloud , il numero massimo di regioni che possono archiviare le viste di analisi | 10 | Non può essere aumentata. Questa funzionalità è in Anteprima pubblica. |
Quote e limiti dell'API Logging
I seguenti limiti si applicano all'utilizzo dell'API Logging. Puoi richiedere modifiche alle quote e ai limiti dell'API Logging. Per istruzioni, consulta Richiedi modifiche alle quote dell'API Cloud Logging in questa pagina.
Per visualizzare le quote delle API, vai alla dashboard API, seleziona un'API, quindi seleziona Quote.
| Categoria | Valore massimo del limite o valore della quota iniziale di |
Note |
|---|---|---|
| Durata dei token di pagina dell'API | 24 ore | Non può essere aumentata. |
| Numero di sessioni di tailing in tempo reale aperte | 10 per progetto Google Cloud | Non può essere aumentata. Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico. |
| Numero di voci di tailing in tempo reale restituite | 60.000 al minuto | Non può essere aumentata. |
| Numero di campi con limitazioni | 20 per bucket | Non può essere aumentata. |
| Dimensioni di un campo con restrizioni | 800 B | Non può essere aumentata. |
Dimensioni di una richiesta entries.write |
10 MB | Non può essere aumentata. |
Frequenza delle richieste entries.write per regione |
4,8 GB al minuto, per progetto Google Cloud nelle regioni
asia-east1,
asia-northeast1,
asia-southeast1,
asia-south1,
europe-west1,
europe-west2,
europe-west3,
europe-west4,
us-central1,
us-east4,
us-west1
300 MB al minuto, per progetto Google Cloud in tutte le regioni rimanenti |
Puoi richiedere un aumento della quota. Questa quota si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchica. Per saperne di più su queste quote, consulta Quote di importazione per regione. L'utilizzo dei filtri di esclusione non riduce la frequenza delle richieste di scrittura perché le voci di log vengono escluse dopo l'invio della richiesta |
Numero di richieste entries.list |
60 al minuto, per progetto Google Cloud | Non può essere aumentata. Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico. Per eseguire query su grandi volumi di log, valuta l'utilizzo delle API BigQuery. Per trasferire grandi volumi di log, valuta la possibilità di utilizzare un sink di log o di copiare le voci di log. |
Numero di nomi di risorse diversi in un singolo comando entries.write |
1000 | Non può essere aumentata. Il campo |
| Richieste di controllo al minuto | 600 | Non può essere aumentata. Questa quota si applica alle richieste API di amministrazione e configurazione. Include tutte le richieste nella quota giornaliera di richieste di controllo, nonché le richieste che eliminano i log o gestiscono risorse come bucket di log, visualizzazioni dei log, policy IAM sulle visualizzazioni dei log, ambiti dei log e metriche basate su log. |
| Richieste di controllo al giorno | 1000 per progetto Google Cloud | Non può essere aumentata. Questa quota si applica alle richieste API per la creazione e l'aggiornamento di esclusioni e sink. |
Numero di progetti Google Cloud o altri nomi di risorse in una singola richiestaentries.list |
100 | Non può essere aumentata. |
| Numero di operazioni di copia simultanee | 1 per progetto Google Cloud | Non può essere aumentata. Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico. |
| Frequenza delle esportazioni negli argomenti Pub/Sub | 60 GB/min per progetto, cartella o organizzazione Google Cloud in cui è definito il sink | Puoi presentare una richiesta di assistenza per aumentare la quota. Viene concesso un aumento della quota in base alla disponibilità di Pub/Sub. Se la frequenza delle esportazioni supera la quota, l'errore viene registrato in una voce di log. Il campo di riepilogo indica un errore di configurazione del sink e il codice di errore è elencato come Per informazioni sulla risoluzione dei problemi, consulta Problemi relativi alle quote con i sink. |
Quote di importazione per regione
Per migliorare l'isolamento e proteggere le risorse regionali dal sovraccarico di importazione, le quote di Cloud Logging limitano il volume di dati scritti in una regione di importazione in base al progettoGoogle Cloud .
La tabella seguente mostra la quota predefinita per ogni regione:
| Regione di importazione | Valore predefinito |
|---|---|
asia-east1,
asia-northeast1,
asia-southeast1,
asia-south1,
europe-west1,
europe-west2,
europe-west3,
europe-west4,
us-central1,
us-east4,
us-west1
|
4,8 GB al minuto, per progetto Google Cloud |
| Tutte le regioni rimanenti | 300 MB al minuto per progetto Google Cloud |
I valori predefiniti per le quote regionali superano i volumi di importazione della maggior parte degli utenti. Tuttavia, se il volume di importazione del tuo progetto da una regione era vicino o superiore alla quota predefinita nei sei o più mesi precedenti l'applicazione delle quote, la quota iniziale include un aumento automatico una tantum. Pertanto, le tue quote potrebbero essere superiori ai valori predefiniti nella tabella precedente. Per informazioni sulla revisione delle quote, consulta Esamina le quote dell'API Cloud Logging.
Se superi una quota regionale, le tue richieste di scrittura all'API Cloud Logging potrebbero essere rifiutate con un messaggio di errore "Risorsa esaurita". Per suggerimenti su come evitare di superare le quote, consulta Gestisci e monitora le quote di Logging.
Esamina le quote dell'API Cloud Logging
Per esaminare le quote dell'API Cloud Logging, segui questi passaggi:
-
Nella console Google Cloud , vai alla pagina Quote e limiti di sistema:
Vai a Quote e limiti di sistema
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo IAM e amministrazione.
- Filtra l'elenco delle quote per il servizio API Cloud Logging.
Richiedi modifiche alle quote dell'API Cloud Logging
Per determinare se puoi richiedere un limite API Logging più alto o più basso per la quota utilizzando la console Google Cloud , vai alla pagina Quote e limiti di sistema e cerca la quota di interesse.
- Se la quota è elencata, puoi utilizzare la pagina per richiedere una modifica del limite. Per informazioni su questi passaggi, consulta Visualizza e gestisci le quote.
- Se la quota non è inclusa nell'elenco o se richiedi un aggiornamento della quota e ricevi l'errore
Edit is not allowed for this quota, contatta l'assistenza clienti Google Cloud e richiedi una modifica della quota. Per modificare le quote nella console Google Cloud , la fatturazione deve essere abilitata nel progettoGoogle Cloud .
Gestisci e monitora le quote dell'API Cloud Logging
Per evitare interruzioni del servizio causate dal superamento delle quote, puoi procedere nel seguente modo:
- Utilizza l'aggiustamento automatico delle quote per monitorare l'utilizzo delle quote e richiedere aumenti per te. Per saperne di più, consulta Aggiustamento delle quote.
- Crea avvisi sulle quote per ricevere notifiche sull'utilizzo. Per saperne di più, consulta Configura gli avvisi quota.
Ottimizza l'utilizzo di entries.list
L'utilizzo previsto di entries.list è la ricerca di log corrispondenti. Questo metodo non è destinato al recupero di un volume elevato di voci di log. Se
esaurisci regolarmente la quota di entries.list, prendi in considerazione
le seguenti opzioni:
Assicurati di utilizzare l'API Cloud Logging in modo efficace. Per saperne di più, consulta Ottimizza l'utilizzo dell'API.
Se sai in anticipo che le voci di log che vuoi analizzare superano la quota di
entries.list, configura un sink di log per esportare i log in una destinazione supportata.
- Per analizzare le voci di log al di fuori di Logging, puoi copiare retroattivamente le voci di log già esistenti in Logging nei bucket Cloud Storage. Quando copi i log in un bucket Cloud Storage, puoi condividere le voci di log con i revisori esterni a Logging ed eseguire script in Cloud Storage.
Per aggregare e analizzare le voci di log all'interno di Logging, archivia le voci di log in un bucket di log, quindi esegui l'upgrade del bucket di log per utilizzare Observability Analytics. Per informazioni su questi passaggi, consulta Configura i bucket di log.
Observability Analytics ti consente di eseguire query sulle voci di log utilizzando SQL standard di BigQuery.
Metriche basate su log
Questa voce si applica solo ai dati delle metriche che Google Cloud Observability ricava dai dati di log (metriche basate su log). Questa sezione non si applica ai dati delle metriche scritti dai servizi Google Cloud o dalle tue applicazioni.
I seguenti limiti si applicano all'utilizzo delle metriche basate su log definite dall'utente. Ad eccezione del numero di descrittori delle metriche, questi limiti sono fissi e non puoi aumentarli o diminuirli.
| Categoria | Valore massimo |
|---|---|
| Numero di etichette | 10 per metrica |
| Lunghezza del valore dell'etichetta | 1024 B |
| Lunghezza della descrizione dell'etichetta | 800 B |
| Lunghezza del filtro1 | 20.000 caratteri |
| Lunghezza dei descrittori delle metriche | 8000 B |
| Numero di descrittori delle metriche | 500 per progetto Google Cloud 2 |
| Numero di serie temporali attive3 | 30.000 per metrica4 |
| Numero di bucket a istogrammi | 200 per metrica di distribuzione personalizzata |
| Conservazione dei dati | Consulta Cloud Monitoring: conservazione dei dati |
1 Ogni metrica basata su log contiene un filtro. Quando una voce di log corrisponde al filtro, viene conteggiata. I filtri vengono definiti utilizzando il linguaggio di query di Logging.
2 Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico.
3 Una serie temporale è attiva se hai scritto
punti dati al suo interno nelle ultime 24
ore.
4 Il sistema limita a 1.000.000 il numero di serie temporali attive per risorsa monitorata. Per le metriche basate su log a livello di progetto, la risorsa è definita dalla risorsa nella voce di log. Per le metriche basate su log con ambito bucket, la risorsa è logging_bucket.
Quando questo limite viene raggiunto, il sistema limita i dati delle metriche per la risorsa. Puoi ridurre il numero di serie temporali per una metrica basata su log riducendone la cardinalità.
Audit logging
Le dimensioni massime degli audit log sono riportate nella tabella seguente. Questi valori possono aiutarti a stimare lo spazio necessario nelle destinazioni sink.
| Tipo di audit log | Dimensione massima |
|---|---|
| Attività di amministrazione | 512 KiB |
| Accesso ai dati | 512 KiB |
| Evento di sistema | 512 KiB |
| Policy Denied | 512 KiB |
Periodi di conservazione dei log
I seguenti periodi di conservazione di Cloud Logging si applicano ai bucket di log, indipendentemente dai tipi di log inclusi nel bucket o dal fatto che siano stati copiati da un'altra posizione:
| Bucket | Risorse | Periodo di conservazione predefinito | Conservazione personalizzata |
|---|---|---|---|
_Required |
progetto, cartella, organizzazione | 400 giorni | Non configurabile |
_Default |
cartella, organizzazione | 30 giorni | Non configurabile |
_Default |
progetto | 30 giorni | Configurabile |
| Definito dall'utente | progetto | 30 giorni | Configurabile |
Per _Default e i bucket di log definiti dall'utente che si trovano nei progetti, puoi configurare Cloud Logging in modo che conservi i log per un periodo compreso tra 1 giorno e3650 days. Per informazioni sull'impostazione delle regole di conservazione, consulta Configura la conservazione personalizzata.
Per archiviare le voci di log di una cartella o di un'organizzazione per più di 30 giorni, crea un sink di log e indirizza le voci di log a un bucket di log in un progetto.
Prezzi
Per informazioni sui prezzi, consulta la pagina Prezzi di Google Cloud Observability. Se esegui il routing dei dati di log ad altri servizi Google Cloud , consulta i seguenti documenti: