Quote e limiti

Questa pagina fornisce i dettagli sui limiti che si applicano all'utilizzo di Cloud Logging.

Limiti di utilizzo di Logging

I seguenti limiti si applicano all'utilizzo di Cloud Logging. A eccezione dei limiti relativi al numero di bucket e sink di log, questi limiti sono fissi e non possono essere aumentati o diminuiti.

Categoria Valore massimo
Dimensione di un LogEntry 256 kB1
Dimensioni di una voce del log di controllo 512 KiB
Numero di etichette 64 per LogEntry
Lunghezza di una chiave di etichetta LogEntry 512 B2
Lunghezza di un valore di etichetta LogEntry 64 kB2
Lunghezza di una query in Linguaggio di query di Logging 20.000 caratteri
Fanout delle query4 200 bucket
Numero di sink 200 per progetto Google Cloud3
Lunghezza di un filtro di inclusione del sink 20.000 caratteri
Lunghezza di un filtro di esclusione del sink 20.000 caratteri
Numero di filtri di esclusione 50 per sink
Numero di bucket di log 100 per progetto Google Cloud3,4,5
Numero di campi indicizzati personalizzati 20 per bucket di log
Numero di visualizzazioni log 30 per bucket di log
Timestamp meno recente che può essere archiviato nei bucket di log6 30 giorni nel passato
Timestamp futuro che può essere archiviato nei bucket di log6 Fino a 1 giorno nel futuro

1Questo limite approssimativo si basa sulle dimensioni interne dei dati e non sulle dimensioni effettive della richiesta API REST.

2 Cloud Logging tronca le chiavi e i valori di etichetta sovradimensionati quando viene scritta la voce di log associata.

3 Questo limite si applica anche agli account di fatturazione, alle cartelle e alle organizzazioni e non è gerarchico. Ad esempio, se un'organizzazione ha più progetti Google Cloud, 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.

4 Questo limite è il numero massimo di bucket che possono contenere voci di log per una risorsa. Per maggiori informazioni, consulta La query restituisce un errore.

5 Questo limite include i bucket in attesa di eliminazione.

6 Le voci di log con timestamp al di fuori di questi limiti vengono rifiutate dai bucket di log. L'API Logging accetta le voci con timestamp precedenti, che possono essere instradate alle destinazioni dei sink, ma non archiviate nell'archiviazione dei log. L'API Logging rifiuta le voci con timestamp che risalgono a più di un giorno prima e restituisce un errore INVALID_ARGUMENT.

Quote e limiti dell'API Logging

I seguenti limiti si applicano al tuo utilizzo dell'API Logging. Puoi richiedere modifiche alle quote e ai limiti dell'API Logging. Per le istruzioni, consulta Richiesta di modifiche alla quota dell'API Cloud Logging in questa pagina.

Categoria Valore massimo
Utilizzo dell'API Per visualizzare le tue quote, accedi alla dashboard delle API. Fai clic su un'API e seleziona Quote.
Durata dei token di pagina dell'API 24 ore
Numero di sessioni aperte di live-tailing 10 per progetto Google Cloud3
Numero di voci di Live-tailing restituite 60.000 al minuto
Numero di campi con restrizioni 20 per bucket
Dimensioni di un campo con restrizioni 800 B
Dimensioni di una richiesta entries.write 10 MB
Numero di richieste entries.write 120.000 al minuto per progetto Google Cloud1, 3
Numero di richieste entries.list 60 al minuto per progetto Google Cloud2, 3
Numero di nomi di risorse diversi in un singolo comando entries.write4 1000
Richieste di controllo5 al minuto 600
Richieste di controllo5 al giorno 1000 per progetto Google Cloud
Numero di progetti Google Cloud o altri nomi di risorse in una singola richiesta entries.list 100
Numero di operazioni di copia simultanee 1 per progetto Google Cloud3
Percentuale di esportazioni in un argomento Pub/Sub6 60 GB al minuto per progetto Google Cloud

1 L'utilizzo dei filtri di esclusione non riduce questo numero perché i log vengono esclusi dopo che è stata effettuata la richiesta entries.write.

2 Questo valore è l'impostazione predefinita.

3 Questo limite si applica anche agli account di fatturazione, alle cartelle e alle organizzazioni e non è gerarchico.

4 Il campo logName di una voce di log specifica il nome della risorsa della voce di log.

5 La quota di richiesta di controllo giornaliera si applica alle richieste API per la creazione e l'aggiornamento di esclusioni e sink. La quota per le richieste di controllo al minuto si applica a tutto ciò che è incluso anche nella quota giornaliera di richieste di controllo, oltre alle richieste API per l'eliminazione dei log e la gestione delle metriche basate su log.

6 Se la percentuale di 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 è indicato come topic_over_quota.

Richiedi modifiche alla quota dell'API Cloud Logging

Puoi richiedere limiti superiori o inferiori per l'API Logging utilizzando la console Google Cloud. Per ulteriori informazioni, consulta Visualizzare e gestire le quote.

Se visualizzi l'errore Edit is not allowed for this quota, puoi contattare l'assistenza per richiedere modifiche alla quota. Tieni inoltre presente che la fatturazione deve essere abilitata nel progetto Google Cloud per selezionare le caselle di controllo.

Ottimizza l'utilizzo di entries.list

L'utilizzo previsto di entries.list è la ricerca di log corrispondenti. Questo metodo non è destinato al recupero di voci di log a volumi elevati. Se esaurisci regolarmente la tua quota di entries.list, prendi in considerazione le seguenti opzioni:

  • Assicurati di utilizzare l'API Cloud Logging in modo efficace. Per maggiori informazioni, consulta la pagina Ottimizzare l'utilizzo dell'API.

  • Se sai in anticipo che le voci di log da analizzare superano la quota 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 in modo retroattivo le voci di log già esistenti nei bucket di Logging nei bucket Cloud Storage. Quando copi i log in un bucket Cloud Storage, puoi condividere le voci di log con i revisori all'esterno di Logging ed eseguire script in Cloud Storage.

Metriche basate su log

I seguenti limiti si applicano all'utilizzo delle metriche basate su log definite dall'utente. Questi limiti sono fissi, ad eccezione del numero di descrittori delle metriche, e non puoi aumentarli o diminuirli.

Categoria Valore massimo
Numero di etichette 10 per metrica
Lunghezza del valore label 1.024 B
Lunghezza della descrizione dell'etichetta 800 B
Lunghezza di un filtro 20.000 caratteri
Lunghezza dei descrittori delle metriche 8000 B
Numero di descrittori delle metriche 500 per progetto Google Cloud2
Numero di serie temporali attive1 30.000 per metrica
Numero di bucket di istogrammi 200 per metrica di distribuzione personalizzata
Conservazione dei dati Consulta Cloud Monitoring: conservazione dei dati

1Una serie temporale è attiva se sono stati inseriti punti dati nelle ultime 24 ore.

2 Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico.

Audit logging

Le dimensioni massime degli audit log sono indicate nella tabella seguente. Questi valori possono aiutarti a stimare lo spazio necessario nelle destinazioni del sink.

Tipo di audit log Dimensioni massime
Attività di amministrazione 512 KiB
Accesso ai dati 512 KiB
Evento di sistema 512 KiB
Norme negate 512 KiB

Periodi di conservazione dei log

I seguenti periodi di conservazione di Cloud Logging si applicano ai bucket di log, indipendentemente dal tipo di log incluso nel bucket o dal fatto che siano stati copiati da un'altra località. Le informazioni sulla conservazione sono le seguenti:

Bucket Periodo di conservazione predefinito Conservazione personalizzata
_Required 400 giorni Non configurabile
_Default 30 giorni Configurabile
Definito dall'utente 30 giorni Configurabile

Per _Default e i bucket di log definiti dall'utente, puoi configurare Cloud Logging in modo da conservare i log per un periodo compreso tra 1 e 3650 giorni. Per informazioni sull'impostazione di regole di conservazione, vedi Configurare la conservazione personalizzata.

Prezzi

Cloud Logging non addebita alcun costo per il routing dei log a una destinazione supportata, ma la destinazione potrebbe applicare dei costi. Ad eccezione del bucket di log _Required, Cloud Logging addebita un costo per lo streaming dei log nei bucket di log e per l'archiviazione per un periodo più lungo rispetto al periodo di conservazione predefinito del bucket di log.

Cloud Logging non addebita alcun costo per la copia dei log o per le query emesse tramite la pagina Esplora log o Analisi dei log.

Per ulteriori informazioni, consulta i seguenti documenti: