Per inviare i dati di traccia al tuo Google Cloud progetto, 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 all'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 utilizza 25 unità di quota. Le chiamate a GetTrace consumano ListSpan 1 unità di quota.
2 Le operazioni di scrittura includono PatchTraces, BatchWrite,
e CreateSpan. Ogni operazione di scrittura utilizza 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 |
1.000 nelle visualizzazioni ROOTSPAN e MINIMAL100 nella visualizzazione COMPLETE |
| Lunghezza massima del nome di un intervallo | 128 byte |
| Numero massimo di etichette o attributi per intervallo | 32 |
| Dimensione massima della chiave per un'etichetta o un attributo | 128 byte |
| Dimensione massima del valore per un'etichetta o un attributo | 256 byte |
| Numero massimo di eventi per intervallo | 128 |
| 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 32. In questo scenario, l'Cloud Trace API utilizza un algoritmo non deterministico per selezionare 32 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.
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'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 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 |
|---|---|
| Dati degli intervalli archiviati da Cloud Trace | 30 giorni |
Bucket _Trace |
30 giorni |
Gestire la quota
Questa sezione descrive come richiedere una modifica di una quota e come monitorare l'utilizzo della quota.
Richiedere modifiche alla quota dell'Cloud Trace API
Puoi richiedere limiti più alti o più bassi per Cloud Trace API utilizzando la Google Cloud console. Per saperne di più, consulta Visualizza e gestisci le quote.
Se viene visualizzato l'errore Edit is not allowed for this quota, puoi
contattare l'assistenza per richiedere modifiche a
la quota. Tieni presente che per selezionare le caselle di controllo è necessario che la fatturazione sia attivata per il
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 tue quote giornaliere di importazione degli intervalli e le tue quote per l'API Cloud Trace, consulta Visualizza e gestisci le quote.
Per scoprire come ridurre le tue unità di quota API e le tue unità di quota giornaliere di importazione degli intervalli, consulta Limitazione dell'utilizzo.
Per richiedere un aumento delle tue unità di quota API o delle tue quote giornaliere di importazione degli intervalli, consulta Richiedere altra quota.
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.