Per inviare i dati di traccia a your Google Cloud project, puoi utilizzare l' API Telemetry (OTLP) o l' API Cloud Trace. L'API Telemetry implementa l'API OpenTelemetry OTLP e offre maggiore compatibilità e supporto per l'ecosistema OpenTelemetry open source. L' API Trace è un'API proprietaria Google Cloud che precede il supporto per l'API Telemetry. I limiti per l'API Telemetry sono spesso più generosi rispetto a quelli dell'API Trace.
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 delle richieste Cloud Trace API e una quota di importazione degli intervalli inviati 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 unità di quota 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 Trace Explorer nella Google Cloud console 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 dell'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 un intervallo | 14 giorni |
| Timestamp futuro massimo per l'importazione 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, l'Cloud Trace API utilizza un algoritmo non deterministico per selezionare 1024 attributi da importare. Gli attributi rimanenti vengono eliminati.
L'API Cloud Trace fornisce dettagli sugli endpoint
GetTrace, PatchTraces e
ListTraces.
Il modo in cui annoti gli intervalli dipende dall'endpoint API Cloud Trace. Se utilizzi l'endpoint
batchWrite aggiungi gli attributi all'
Span oggetto. Se utilizzi l'endpoint
patchTraces, aggiungi le etichette all'oggetto
TraceSpan.
Quote e limiti 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'API Cloud Trace.
| Descrizione | Valore | Nota |
|---|---|---|
| Dimensione massima delle chiavi degli attributi | 512 byte | Limite. |
| Dimensione massima dei valori degli attributi | 64 KiB | Limite. |
Dimensione massima del nome di un oggetto Span* |
1024 byte | Limite. |
Numero massimo di attributi collegati a un Span* oggetto |
1024 | Limite. |
Numero massimo di attributi delle risorse per ResourceSpans* oggetto |
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 Event* oggetti per oggetto Span* |
256 | Limite. |
Numero massimo di Link* oggetti per Span* oggetto |
128 | Limite. |
Dimensione massima del nome di un oggetto Event* |
1024 byte | Limite. |
Numero massimo di attributi per Event* oggetto |
1024 | Limite. |
Numero massimo di attributi per Link* oggetto |
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 degli ambiti delle tracce
| Limiti degli ambiti delle tracce | Valore |
|---|---|
| Numero massimo di ambiti delle tracce per progetto | 100 |
| Numero massimo di visualizzazioni per ambito delle tracce | 20 |
Periodi di conservazione di Trace
| Categoria | Periodo di conservazione |
|---|---|
Intervalli archiviati nel
_Trace bucket |
30 giorni |
Gestire la quota
Questa sezione descrive come richiedere una modifica di una quota e come monitorare l'utilizzo della quota.
Richiedere modifiche alle quote dell'Cloud Trace API
Per determinare se puoi richiedere un limite di quota dell'Cloud Trace API più alto o più basso utilizzando la Google Cloud console, vai alla pagina Quote e limiti di sistema e cerca la quota di interesse.
- Se la quota è elencata, puoi utilizzare questa pagina per richiedere una modifica del limite. Per informazioni su questi passaggi, consulta Visualizzare e gestire 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 Google Cloud console, la fatturazione deve essere abilitata nel Google Cloud progetto.
Monitorare l'utilizzo della quota
Per evitare di esaurire la quota e perdere osservabilità sulle prestazioni delle tue applicazioni, verifica di raggruppare gli aggiornamenti e monitorare l'utilizzo della quota. Ad esempio, puoi 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 le quote giornaliere di importazione degli intervalli e le quote dell'API Cloud Trace, consulta Visualizzare e gestire le quote.
Per scoprire come ridurre le unità di quota API e le unità di quota giornaliere di importazione degli intervalli, consulta Limitare l'utilizzo.
Per richiedere un aumento delle unità di quota API o delle quote giornaliere di importazione degli intervalli, consulta Richiedere altra quota.
Consulta Creare 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.
Esecuzione di query a volumi elevati
Per eseguire query a volumi elevati sui dati di traccia, crea un set di dati BigQuery collegato e poi utilizza l'API BigQuery.
Non utilizzare l'Cloud Trace API per le query a volumi elevati perché le chiamate all'API Trace sono soggette a limiti di frequenza.