Quote e limiti

Questa pagina fornisce i dettagli sui limiti che si applicano quando si utilizza Cloud Logging.

Limiti di utilizzo di Logging

I seguenti limiti si applicano all'utilizzo di Cloud Logging. Ad eccezione dei limiti 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 di audit log 512 KiB
Numero di etichette 64 per LogEntry
Lunghezza di una chiave di etichetta LogEntry 512 B2
Lunghezza del valore dell'etichetta LogEntry 64 KB2
Lunghezza di una query linguaggio di query di Logging 20.000 caratteri
Query fanout4 200 bucket
Numero di lavabi 200 per Google Cloud progetto3
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 Google Cloud progetto3,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 Determinato dal periodo di conservazione predefinito del bucket di log. Per un bucket di log personalizzato con il periodo di conservazione predefinito, questo valore è 30 giorni nel passato.
Timestamp futuro che può essere archiviato nei bucket di log6 Fino a 1 giorno in futuro
Numero di ambiti di log per risorsa 100
Numero di visualizzazioni di log e progetti inclusi in un ambito di log 100
Numero di progetti inclusi in un ambito di log 5
Numero massimo di viste Analytics per progetto Google Cloud 7 100
Per Google Cloud progetto, il numero massimo di viste Analytics per regione7 50
Per Google Cloud progetto, il numero massimo di regioni che possono memorizzare le viste di Analytics7 10

1 Questo 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 delle etichette di dimensioni eccessive quando viene scritta la voce di log associata.
3 Questo limite si applica anche a account di fatturazione, cartelle e organizzazioni e non è gerarchico. Ad esempio, se hai più progettiGoogle 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.
4 Questo limite è il numero massimo di bucket che potrebbero contenere voci di log per una risorsa. Per maggiori informazioni, vedi 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 voci con timestamp precedenti e queste voci possono essere indirizzate alle destinazioni sink, ma non archiviate nell'archivio log. L'API Logging rifiuta le voci con timestamp successivi di più di 1 giorno e restituisce un errore INVALID_ARGUMENT.
7Questa funzionalità è in anteprima pubblica.

Quote e limiti dell'API Logging

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

Categoria Valore massimo
Utilizzo delle API Per visualizzare le tue quote, vai alla dashboard delle API, seleziona un'API e poi Quote.
Durata dei token di pagina dell'API 24 ore
Numero di sessioni di logging in tempo reale aperte 10 per Google Cloud progetto3
Numero di voci di logging in tempo reale restituite 60.000 al minuto
Numero di campi con restrizioni 20 per bucket
Dimensione di un campo con restrizioni 800 B
Dimensioni di una richiesta entries.write 10 MB
Numero di entries.write richieste
Quota in fase di sostituzione; per ulteriori informazioni, vedi Quote di importazione per regione		 120.000 al minuto per Google Cloud progetto1, 3;
illimitato dopo il 4 agosto 2025;
quota rimossa dopo l'11 agosto 2025
Tasso di richieste entries.write, per regione
Quote in fase di aggiunta. Per ulteriori informazioni, vedi Quote di importazione per regione		 4,8 GB al minuto, per Google Cloud progetto, nelle regioni asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 1, 3

300 MB al minuto, per Google Cloud progetto, in tutte le altre regioni1, 3
Numero di richieste entries.list 60 al minuto per Google Cloud progetto2, 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 Google Cloud progetti o altri nomi di risorse in una
singola richiesta entries.list		 100
Numero di operazioni di copia simultanee 1 per Google Cloud progetto3
Tasso di esportazioni in un argomento Pub/Sub6 60 GB al minuto per Google Cloud progetto

1 L'utilizzo di 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 a account di fatturazione, cartelle e 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 richieste di controllo giornaliera si applica alle richieste API per la creazione e l'aggiornamento di esclusioni e sink. La quota di richieste di controllo al minuto si applica a tutto ciò che è incluso anche nella quota di richieste di controllo giornaliera, oltre alle richieste API per l'eliminazione dei log e la gestione delle metriche basate sui log.
6 Se la frequenza di esportazione supera la quota, l'errore viene registrato in una voce di log. Il campo riepilogativo indica un errore di configurazione del sink e il codice di errore è topic_over_quota.

Quote di importazione per regione

A partire dal 4 agosto 2025, le quote di Cloud Logging limiteranno, in base al progettoGoogle Cloud , il volume di dati scritti in una regione di importazione. Il 4 agosto 2025, Cloud Logging smetterà di limitare il numero di richieste API entries.write da un progetto Google Cloud . Questa modifica ha lo scopo di migliorare l'isolamento e proteggere le risorse regionali dal sovraccarico di importazione.

La seguente tabella 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 Google Cloud progetto
Tutte le regioni rimanenti 300 MB al minuto per Google Cloud progetto

I valori predefiniti per le quote regionali superano i volumi di importazione della maggior parte degli utenti. Tuttavia, se prima del 4 agosto 2025, il volume di importazione del tuo progetto da una regione nei sei o più mesi precedenti è vicino o superiore alla quota predefinita per quella regione, la tua quota iniziale include un aumento automatico una tantum. Pertanto, le tue quote potrebbero essere superiori ai valori predefiniti nella tabella precedente.

Puoi rivedere le quote regionali prima del 4 agosto 2025, ma le quote non vengono applicate fino a dopo questa data. Per informazioni sulla revisione delle quote, consulta Esamina le quote di Logging.

Il 4 agosto 2025, la quota per il numero di richieste entries.write verrà modificata in illimitata.

L'11 agosto 2025, la quota per il numero di richieste entries.write verrà rimossa.

Se superi una quota regionale dopo il 4 agosto 2025, 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 la pagina Gestire e monitorare le quote di Logging.

Esamina le quote dell'API Cloud Logging

Per esaminare le quote dell'API Cloud Logging:

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

  2. Filtra l'elenco delle quote per il servizio API Cloud Logging.

Richiedere modifiche alla quota dell'API Cloud Logging

Puoi richiedere limiti più alti o più bassi per l'API Logging utilizzando la consoleGoogle Cloud . Per ulteriori informazioni, vedi Visualizza e gestisci le quote.

Se ricevi l'errore Edit is not allowed for this quota, puoi contattare l'assistenza per richiedere modifiche alla quota. Tieni presente inoltre che per poter selezionare le caselle di controllo è necessario che la fatturazione sia attivata per il progettoGoogle Cloud .

Gestire e monitorare le quote dell'API Cloud Logging

Per evitare interruzioni del servizio causate dal superamento delle quote, puoi procedere come segue:

  • Utilizza l'aggiustamento automatico delle quote per monitorare l'utilizzo delle quote e richiedere aumenti per tuo conto. Per ulteriori informazioni, vedi Aggiustamento delle quote.
  • Crea avvisi sulle quote per ricevere notifiche sull'utilizzo. Per ulteriori informazioni, consulta Configurare gli avvisi sulla quota.

Ottimizzare l'utilizzo di entries.list

L'utilizzo previsto di entries.list è la ricerca di log corrispondenti. Questo metodo non è concepito per il recupero di un volume elevato di voci di log. Se esaurisci regolarmente la quota di entries.list, valuta le seguenti opzioni:

  • Assicurati di utilizzare l'API Cloud Logging in modo efficace. Per ulteriori informazioni, consulta Ottimizzare 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 revisori esterni a Logging ed eseguire script in Cloud Storage.

  • Per aggregare e analizzare le voci di log in Logging, memorizza le voci di log in un bucket di log, quindi esegui l'upgrade di questo bucket di log per utilizzare Analisi dei log. Per informazioni su questi passaggi, consulta la sezione Configurare i bucket dei log.

    Analisi dei log consente di eseguire query sulle voci di log utilizzando SQL standard di BigQuery.

Metriche basate su log

I seguenti limiti si applicano al tuo utilizzo delle metriche basate sui log definite dall'utente. Ad eccezione del numero di descrittori delle metriche, questi limiti sono fissi e non possono essere aumentati o diminuiti.

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 Google Cloud progetto2
Numero di serie temporali attive3 30.000 per metrica
Numero di bucket dell'istogramma 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 a account di fatturazione, cartelle e organizzazioni e non è gerarchico.
3Una serie temporale è attiva se sono stati inseriti dei punti dati nelle ultime 24 ore.

Audit logging

Le dimensioni massime dei log di controllo sono riportate nella tabella seguente. Questi valori possono aiutarti a stimare lo spazio necessario nelle tue destinazioni sink.

Tipo di audit log Dimensioni massime
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. Di seguito sono riportate le informazioni sulla conservazione:

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

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

Prezzi

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

Cloud Logging non addebita costi per la copia dei log, per la creazione di ambiti dei log o visualizzazioni di analisi o per le query emesse tramite le pagine Esplora log o Analisi dei log.

Per saperne di più, consulta i seguenti documenti: