Cloud Trace applica quote di frequenza, limiti di importazione degli span e periodi di conservazione dei dati che dipendono dall'invio dei dati di traccia tramite l'API Telemetry (OTLP) o l'API Cloud Trace. Comprendere queste soglie ti aiuta a monitorare l'utilizzo in modo da non perdere l'osservabilità delle tue applicazioni.
Quote e limiti dell'API Trace
Questa sezione fornisce informazioni su quote e limiti che si applicano solo all'API Trace. Le quote e i limiti elencati in questa sezione non si applicano all'API Telemetry.
Cloud Trace applica due diversi tipi di quote: una quota di frequenza per le richieste Cloud Trace API e una quota di importazione per gli intervalli che invii a Trace.
Quote
La tabella seguente riassume le unità di quota disponibili per le operazioni di lettura e scrittura e la quota giornaliera per l'importazione degli intervalli per l'API Trace. Ad esempio, hai un totale di 300 richieste ogni 60 secondi per i tre comandi API GetTrace, ListTraces e ListSpan. Ecco due diversi
esempi di come utilizzare tutte le unità di quota disponibili:
- Puoi eseguire 12 chiamate API
ListTracesogni 60 secondi. - Puoi eseguire 10 chiamate API
ListTracese 50 chiamate APIGetTraceogni 60 secondi.
| Categoria | Unità di quota totali |
|---|---|
| Operazioni di lettura1 | 300 per 60 secondi |
| Operazioni di scrittura2 | 4.800 per 60 secondi |
| Intervalli importati3,4 | 3.000.000 al giorno-5.000.000.000 al giorno |
1 Le operazioni di lettura includono GetTrace, ListTraces,
ListSpan. Una chiamata a ListTraces consuma 25 unità di quota. Le chiamate a GetTrace consumano ListSpan 1 unità di quota. L'esecuzione di query e la visualizzazione delle tracce utilizzando Esplora tracce nella console Google Cloud non consumano questa quota.
2 Le operazioni di scrittura includono PatchTraces, BatchWrite e CreateSpan. Ogni operazione di scrittura consuma 1 unità di quota.
3 Questa quota si applica solo agli intervalli importati utilizzando l'Cloud Trace API.
L'importazione tramite l'API Telemetry non è soggetta a restrizioni.
4 La quota giornaliera di importazione degli intervalli di traccia per l'Cloud Trace API è determinata dalla cronologia del tuo account di fatturazione e dalle richieste di aumento della quota che hai effettuato.
Limiti
Questa tabella elenca i limiti per l'Cloud Trace API.
| Descrizione | Valore |
|---|---|
Numero massimo di intervalli per chiamata GetTrace |
10.000 |
Numero massimo di intervalli per chiamata PatchTraces |
25.000 |
Numero massimo di tracce per chiamata ListTraces |
1000 nelle visualizzazioni ROOTSPAN e MINIMAL100 nella visualizzazione COMPLETE |
| Lunghezza massima del nome di un intervallo | 1024 byte |
| Numero massimo di etichette o attributi per intervallo | 1024 |
| Dimensione massima della chiave per un'etichetta o un attributo | 512 byte |
| Dimensione massima del valore per un'etichetta o un attributo | 65.532 byte |
| Numero massimo di eventi per intervallo | 256 |
| Timestamp passato massimo per l'importazione di uno span | 14 giorni |
| Timestamp futuro massimo per l'importazione di uno span | 3 giorni |
| Timestamp passato massimo per l'evento relativo al timestamp dell'intervallo | 365 giorni |
Il superamento di un limite potrebbe non comportare l'esito negativo di una chiamata API con un errore. Ad esempio, non viene segnalato un errore quando il numero di attributi collegati a uno span supera 1024. In questo scenario, l'Cloud Trace API utilizza un algoritmo non deterministico per selezionare 1024 attributi da importare. Gli attributi rimanenti vengono ignorati.
L'API Cloud Trace fornisce dettagli sugli endpoint GetTrace, PatchTraces e ListTraces.
Il modo in cui annoti gli intervalli dipende dall'endpoint Cloud Trace API. Se utilizzi l'endpoint batchWrite, aggiungi gli attributi all'oggetto Span. Se utilizzi l'endpoint patchTraces, aggiungi le etichette all'oggetto TraceSpan.
Limiti e quote dell'API Telemetry
Questa sezione elenca i limiti che si applicano solo quando l'API Telemetry viene utilizzata per importare i dati di traccia. L'API Telemetry, che implementa l'API OpenTelemetry OTLP, è progettata per l'utilizzo con applicazioni instrumentate utilizzando uno degli SDK OpenTelemetry. I limiti elencati in questa sezione non si applicano all'Cloud Trace API.
| Descrizione | Valore | Nota |
|---|---|---|
| Dimensione massima delle chiavi attributo | 512 byte | Limite. |
| Dimensione massima dei valori degli attributi | 64 KiB | Limit. |
Dimensioni massime del nome di un oggetto Span* |
1024 byte | Limite. |
Numero massimo di attributi associati a un oggetto Span* |
1024 | Limit. |
Numero massimo di attributi delle risorse per oggetto ResourceSpans* |
1024 | Limit. |
Numero massimo di attributi per oggetto ResourceSpan*Include gli attributi associati agli oggetti secondari dei seguenti tipi: Resource, Span, ScopeSpans,
Event e Link. |
8192 | Limite. |
Numero massimo di oggetti Event* per oggetto Span* |
256 | Limite. |
Numero massimo di oggetti Link* per oggetto Span* |
128 | Limite. |
Dimensioni massime del nome di un oggetto Event* |
1024 byte | Limit. |
Numero massimo di attributi per oggetto Event* |
1024 | Limite. |
Numero massimo di attributi per oggetto Link* |
1024 | Limit. |
| Dimensione massima degli URL dello schema | 8192 byte | Limit. |
| Numero massimo di byte di importazione delle tracce al minuto | 2,4 GB per le seguenti regioni: 300 MB per tutte le altre regioni. |
Quota. |
trace.proto.
Limiti degli ambiti di traccia
| Limiti degli ambiti di traccia | Valore |
|---|---|
| Numero massimo di ambiti di traccia per progetto | 100 |
| Numero massimo di visualizzazioni per ambito di traccia | 20 |
Periodi di conservazione di Trace
| Categoria | Periodo di conservazione |
|---|---|
Intervalli archiviati nel bucket _Trace |
30 giorni |
Gestisci la tua quota
Questa sezione descrive come richiedere una modifica di una quota e come monitorare l'utilizzo della quota.
Richiedi modifiche alle quote dell'Cloud Trace API
Per determinare se puoi richiedere un limite Cloud Trace API più alto o più basso per 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 è elencata o se richiedi un aggiornamento della quota e ricevi l'errore
Edit is not allowed for this quota, contatta l'assistenza e richiedi una modifica della quota. Per modificare le quote nella console Google Cloud , la fatturazione deve essere abilitata nel progettoGoogle Cloud .
Monitora l'utilizzo della quota
Per assicurarti di non esaurire la quota e di non perdere l'osservabilità delle prestazioni delle tue app, verifica di raggruppare gli aggiornamenti e di monitorare l'utilizzo della quota. Ad esempio, potresti creare una criterio di avviso che ti avvisa quando l'utilizzo supera una soglia. Per informazioni dettagliate sul monitoraggio delle richieste API e delle relative risposte, consulta la pagina Monitoraggio dell'utilizzo delle API.
Per visualizzare l'API Cloud Trace e le quote di importazione degli intervalli giornalieri, consulta Visualizza e gestisci le quote.
Per scoprire come ridurre le unità di quota API e le unità di quota di importazione degli intervalli giornalieri, consulta Limitazione dell'utilizzo.
Per richiedere un aumento delle unità di quota dell'API o delle quote di importazione degli intervalli giornalieri, consulta Richiedi una quota maggiore.
Per informazioni dettagliate sulla creazione di policy di avviso per monitorare la quota dell'API Trace e l'importazione degli intervalli di traccia, consulta Creazione di un avviso di superamento della quota.
Query ad alto volume
Per eseguire query su un volume elevato di dati di traccia, crea un set di dati BigQuery collegato e poi utilizza l'API BigQuery.
Non utilizzare l'Cloud Trace API per query con volumi elevati, perché le chiamate all'API Trace sono soggette a limitazione di frequenza.