Cloud Trace applica quote di velocità, limiti di importazione degli span e periodi di conservazione dei dati che dipendono dall'API utilizzata per inviare i dati di traccia al tuo progetto Google Cloud : l'API Telemetry (OTLP) o l'API Cloud Trace. L'API Telemetry implementa la specifica OpenTelemetry OTLP e offre una maggiore compatibilità con l'ecosistema open source OpenTelemetry.
Quote e limiti dell'API Trace
Questa sezione fornisce informazioni sulle quote e sui 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 span 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 di span per l'API Trace. Ad esempio,
hai un totale di 300 per 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 |
| Span acquisiti3,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 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 inseriti 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 di un nome di span | 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 un intervallo | 14 giorni |
| Timestamp futuro massimo per l'inserimento di un intervallo | 3 giorni |
| Timestamp passato massimo per l'evento rispetto 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 un intervallo supera 1024. In questo scenario, invece, l'Cloud Trace APIe utilizza un algoritmo non deterministico per selezionare 1024 attributi da importare. Gli altri attributi vengono eliminati.
L'API Cloud Trace fornisce dettagli sugli endpoint
GetTrace, PatchTraces e
ListTraces.
Il modo in cui annoti gli span dipende dall'endpoint API Cloud Trace. 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 APIe.
| Descrizione | Valore | Nota |
|---|---|---|
| Dimensioni massime delle chiavi attributo | 512 byte | Limite. |
| Dimensione massima dei valori degli attributi | 64 KiB | Limite. |
Dimensioni massime del nome di un oggetto Span* |
1024 byte | Limite. |
Numero massimo di attributi collegati a un oggetto Span* |
1024 | Limite. |
Numero massimo di attributi risorsa per oggetto ResourceSpans* |
1024 | Limite. |
Numero massimo di attributi per oggetto ResourceSpan*Include gli attributi collegati 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. |
Dimensione massima del nome di un oggetto Event* |
1024 byte | Limite. |
Numero massimo di attributi per oggetto Event* |
1024 | Limite. |
Numero massimo di attributi per oggetto Link* |
1024 | Limite. |
| Dimensione massima degli URL dello schema | 8192 byte | Limite. |
| 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 relativi agli ambiti delle tracce
| Limiti relativi agli ambiti delle tracce | Valore |
|---|---|
| Numero massimo di ambiti della traccia per progetto | 100 |
| Numero massimo di viste per ambito della traccia | 20 |
Periodi di conservazione di Trace
| Categoria | Periodo di conservazione |
|---|---|
Span archiviati nel
bucket _Trace |
30 giorni |
Gestire la quota
Questa sezione descrive come richiedere una modifica a una quota e come monitorare l'utilizzo della quota.
Richiedere modifiche alle quote dell'Cloud Trace API
Per determinare se puoi richiedere un limite Cloud Trace API superiore o inferiore 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 quella pagina per richiedere una modifica al limite. Per informazioni su questi passaggi, vedi 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, allora 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 .
Monitorare l'utilizzo della quota
Per assicurarti di non esaurire la quota e perdere l'osservabilità delle prestazioni delle tue app, verifica di raggruppare gli aggiornamenti e monitora l'utilizzo della quota. Ad esempio, potresti creare una criterio di avviso che ti avvisi 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 giornaliere di importazione di span, consulta Visualizzare e gestire le quote.
Per scoprire come ridurre le unità di quota API e le unità di quota di importazione dell'intervallo giornaliero, consulta Limitare l'utilizzo.
Per richiedere un aumento delle unità di quota API o delle quote di importazione giornaliere degli span, consulta Richiedere una quota maggiore.
Consulta Creazione di un avviso di superamento della quota per informazioni dettagliate su come creare criteri di avviso per monitorare la quota dell'API Trace e la frequenza di importazione degli intervalli delle tracce.
Query ad alto volume
Per eseguire query ad alto volume sui dati di traccia, crea un set di dati BigQuery collegato e poi utilizza l'API BigQuery.
Non utilizzare l'Cloud Trace API per query ad alto volume perché le chiamate all'API Trace sono soggette a limitazioni di frequenza.