Questa pagina fornisce i dettagli sui limiti che si applicano quando si utilizza Cloud Logging.
Quote e limiti di utilizzo di Logging
La tabella seguente elenca le quote e i limiti applicabili all'utilizzo di Cloud Logging. In generale, puoi richiedere un aumento per 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ù Google Cloud progetti in un'organizzazione, puoi configurare fino a 200 sink per ogni Google Cloud progetto. Per la stessa organizzazione, puoi anche configurare fino a 200 sink a livello di organizzazione.
| Categoria | Valore massimo del limite o valore iniziale della quota |
Note |
|---|---|---|
Dimensione di un
LogEntry |
256 KB | Questo limite è approssimativo e si basa sulle dimensioni interne dei dati, non sulle dimensioni effettive della richiesta API REST. Non può essere aumentato. |
| Dimensioni di una voce di audit log | 512 KiB | Non può essere aumentato. |
| Numero di etichette | 64 per LogEntry |
Non può essere aumentato. |
Lunghezza di una chiave di etichetta LogEntry |
512 B | Cloud Logging tronca le chiavi delle etichette sovradimensionate quando viene scritta la voce di log associata. Non può essere aumentato. |
Lunghezza del valore dell'etichetta LogEntry |
64 kB | Cloud Logging tronca i valori delle etichette sovradimensionati quando viene scritta la voce di log associata. Non può essere aumentato. |
| Lunghezza di una query linguaggio di query di Logging | 20.000 caratteri | Non può essere aumentato. |
| Query fan-out | 200 bucket | Questo limite corrisponde al numero massimo di bucket che potrebbero contenere voci di log per una risorsa. Per saperne di più, consulta La query restituisce un errore. Non può essere aumentato. Per motivi di prestazioni, riduci al minimo il numero di bucket di log e creali in una sola regione. Se devi spesso eseguire query sulle voci di log provenienti da risorse diverse, valuta la possibilità di indirizzare le voci di log a pochi bucket di log centralizzati. |
| Numero di lavabi | 200 per Google Cloud progetto | Può essere aumentato fino a 4000. Questa quota si applica anche a account di fatturazione, cartelle e organizzazioni e non è gerarchica. |
| Lunghezza di un filtro di inclusione del sink | 20.000 caratteri | Non può essere aumentato. |
| Lunghezza di un filtro di esclusione del sink | 20.000 caratteri | Non può essere aumentato. |
| Numero di filtri di esclusione | 50 per sink | Non può essere aumentato. Se hai bisogno di più di 50 filtri di esclusione, perfeziona il filtro di inclusione. |
| Numero di bucket di log | 100 per Google Cloud progetto | Può essere aumentato fino a 2500. Questa quota corrisponde al numero massimo di bucket che potrebbero contenere voci di log per una risorsa e include i bucket in attesa di eliminazione. Questa quota si applica anche a account di fatturazione, cartelle e organizzazioni e non è gerarchica. Se aumenti il numero massimo di bucket di log, potresti avere un'esperienza utente peggiore perché l'ambito dei log predefinito non può includere tutti i bucket di log in un progetto. |
| Numero di campi indicizzati personalizzati | 20 per bucket di log | Non può essere aumentato. Cloud Logging supporta l'indicizzazione integrale. Pertanto, non ti consigliamo di definire l'indicizzazione personalizzata. |
| Numero di visualizzazioni di log | 30 per bucket di log | Può essere aumentato a 1000 visualizzazioni di log in un singolo bucket di log. Se aumenti il numero massimo di visualizzazioni di log, potresti avere un'esperienza utente peggiore perché l'ambito dei log predefinito non può includere tutti i bucket 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 è 30 giorni nel passato. L'API Logging accetta le voci di log con timestamp precedenti e queste voci di log vengono indirizzate alle destinazioni sink. Tuttavia, se le voci di log con timestamp precedenti vengono indirizzate a un bucket di log, non vengono archiviate. |
| Timestamp futuro che può essere archiviato nei bucket di log | Fino a 1 giorno in futuro | L'API Logging rifiuta le voci con timestamp
successivi di più di 1 giorno e restituisce un
errore INVALID_ARGUMENT. Non può essere aumentato. |
| Numero di ambiti di log per risorsa | 100 | Può essere aumentato fino 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. L'elenco delle visualizzazioni dei log comporta una riduzione del tempo di query e una maggiore chiarezza in merito alle voci di log sottoposte a query. |
| Numero di progetti inclusi in un ambito di log | 5 | Ti consigliamo di elencare le visualizzazioni dei log anziché i progetti in un ambito dei log, se possibile. Le visualizzazioni di log possono trovarsi in progetti diversi. |
| Numero massimo di viste Analytics per progetto Google Cloud | 100 | Non può essere aumentato. Questa funzionalità è in Anteprima pubblica. |
| Per progetto Google Cloud , il numero massimo di viste Analytics per regione | 50 | Non può essere aumentato. Questa funzionalità è in Anteprima pubblica. |
| Per progetto Google Cloud , il numero massimo di regioni che possono archiviare le visualizzazioni di analisi | 10 | Non può essere aumentato. Questa funzionalità è in Anteprima pubblica. |
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 istruzioni, consulta Richiesta di modifiche alla quota dell'API Cloud Logging in questa pagina.
Per visualizzare le quote API, vai alla dashboard delle API, seleziona un'API e poi Quote.
| Categoria | Valore massimo del limite o valore iniziale della quota |
Note |
|---|---|---|
| Durata dei token di pagina dell'API | 24 ore | Non può essere aumentato. |
| Numero di sessioni di logging in tempo reale aperte | 10 per progetto Google Cloud | Non può essere aumentato. Questo limite si applica anche ad account di fatturazione, cartelle e organizzazioni e non è gerarchico. |
| Numero di voci di logging in tempo reale restituite | 60.000 al minuto | Non può essere aumentato. |
| Numero di campi con restrizioni | 20 per bucket | Non può essere aumentato. |
| Dimensione di un campo con restrizioni | 800 B | Non può essere aumentato. |
Dimensioni di una richiesta entries.write |
10 MB | Non può essere aumentato. |
Tasso di richieste entries.write,
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
300 MB al minuto per Google Cloud progetto, 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 di 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 di entries.list |
60 al minuto per Google Cloud progetto | Non può essere aumentato. Questo limite si applica anche a account di fatturazione, cartelle e organizzazioni e non è gerarchico. Per eseguire query su grandi volumi di log, valuta la possibilità di utilizzare le API BigQuery. Per il trasferimento di grandi volumi di log, valuta la possibilità di utilizzare un sink di log o Copia voci di log. |
Numero di nomi di risorse diversi in un singolo comando entries.write |
1000 | Non può essere aumentato. Il campo |
| Richieste di controllo al minuto | 600 | Non può essere aumentato. Questa quota si applica anche a tutto ciò che è incluso nella quota giornaliera di richieste di controllo, oltre alle richieste API per l'eliminazione dei log e la gestione delle metriche basate sui log. |
| Richieste di controllo al giorno | 1000 per progetto Google Cloud | Non può essere aumentato. Questa quota si applica alle richieste API per la creazione e l'aggiornamento di esclusioni e sink. |
| Numero di Google Cloud progetti o altri nomi di risorse in una singola richiesta entries.list |
100 | Non può essere aumentato. |
| Numero di operazioni di copia simultanee | 1 per progetto Google Cloud | Non può essere aumentato. Questo limite si applica anche a account di fatturazione, cartelle e organizzazioni e non è gerarchico. |
| Tasso di esportazioni negli argomenti Pub/Sub | 60 GB al minuto per Google Cloud progetto, cartella o organizzazione in cui è definito il sink | Puoi presentare una richiesta di assistenza per aumentare la quota. L'aumento della quota viene concesso in base alla disponibilità di Pub/Sub. Se la velocità di esportazione supera la quota, l'errore viene
registrato in una voce di log. Il campo riepilogativo indica l'errore di configurazione del sink e il codice di errore è elencato come |
Quote di importazione per regione
Per migliorare l'isolamento e proteggere le risorse regionali dal sovraccarico di importazione, le quote di Cloud Logging limitano, in base al singolo progettoGoogle Cloud , il volume di dati scritti in una regione di importazione.
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 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 dell'applicazione delle quote, il volume di importazione del tuo progetto da una regione nei sei o più mesi precedenti era 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. Per informazioni sulla revisione delle quote, consulta Esaminare le quote di 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 Gestire e monitorare le quote di Logging.
Esamina le quote dell'API Cloud Logging
Per esaminare le quote dell'API Cloud Logging:
-
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.
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 saperne di più, consulta 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 selezionare le caselle di controllo è necessario che la fatturazione sia attivata nel 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 saperne di più, consulta Aggiustamento delle quote.
- Crea avvisi sulle quote per ricevere notifiche sull'utilizzo. Per ulteriori informazioni, consulta Configurare gli avvisi relativi alla 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 saperne di più, 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 log.
Analisi dei log consente di eseguire query sulle voci di log utilizzando SQL standard 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 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 a account di fatturazione, cartelle e
organizzazioni e non è gerarchico.
3Una serie temporale è attiva se sono stati inseriti
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 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. 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 Configura la conservazione personalizzata.
Prezzi
Per informazioni sui prezzi, consulta la pagina Prezzi di Google Cloud Observability. Se indirizzi i dati di log ad altri servizi, consulta i seguenti documenti: Google Cloud