Per inviare i dati di traccia al tuo progetto Google Cloud , 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 dell'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 per le richieste Cloud Trace API e una quota di importazione per gli intervalli inviati a Trace.
Quote
La seguente tabella riassume le unità di quota disponibili per le operazioni di lettura e scrittura e la quota giornaliera per l'importazione di intervalli per l'API Trace. Ad esempio,
hai un totale di 300 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 | 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 utilizzano 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 La quota giornaliera di importazione di intervalli di tracce viene determinata in base alla cronologia dell'account di fatturazione e alle richieste di aumento della quota effettuate.
Limiti
Questa tabella elenca i limiti per l'Cloud Trace API.
| Descrizione | Valore |
|---|---|
Numero massimo di intervalli per chiamata GetTrace |
1000 |
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 |
| Numero massimo di intervalli per traccia | 1000 |
| Dimensione massima della traccia | 50 MB |
| Lunghezza massima del nome di uno span | 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 uno span | 14 giorni |
| Timestamp futuro massimo per l'inserimento di uno span | 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 uno span supera 32. In questo scenario, invece, l'Cloud Trace APIe 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 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 dell'API Telemetry
Questa sezione elenca i limiti applicabili solo quando l'API Telemetry viene utilizzata per importare i dati di tracciamento. 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 |
|---|---|
| Dimensione massima delle chiavi degli attributi | 512 byte |
| Dimensione massima dei valori degli attributi | 64 KiB |
Dimensione massima del nome di un oggetto Span* |
1024 byte |
Numero massimo di attributi collegati a un oggetto Span* |
1024 |
Numero massimo di attributi risorsa per oggetto ResourceSpans* |
1024 |
Numero massimo di attributi per oggetto ResourceSpan*Include gli attributi collegati agli oggetti secondari dei seguenti tipi: Resource, Span, ScopeSpans,
Event e Link. |
8192 |
Numero massimo di oggetti Event* per oggetto Span* |
256 |
Numero massimo di oggetti Link* per oggetto Span* |
128 |
Dimensione massima del nome di un oggetto Event* |
1024 byte |
Numero massimo di attributi per oggetto Event* |
1024 |
Numero massimo di attributi per oggetto Link* |
1024 |
| Dimensione massima degli URL dello schema | 8192 byte |
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 progetti per ambito della traccia | 20 |
Periodi di conservazione di Trace
| Categoria | Periodo di conservazione |
|---|---|
| Dati degli intervalli archiviati da Cloud 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 l'Cloud Trace API utilizzando la consoleGoogle Cloud . Per ulteriori informazioni, vedi 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 poter selezionare le caselle di controllo è necessario che la fatturazione sia attivata per il progettoGoogle Cloud .
Monitorare l'utilizzo della quota
Per evitare di esaurire la quota e perdere visibilità sulle prestazioni delle tue applicazioni, assicurati di raggruppare gli aggiornamenti e monitorare l'utilizzo della quota. Ad esempio, potresti creare un criterio di avviso che ti invii una notifica quando il tuo 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 Visualizzare e gestire le quote.
Per scoprire come ridurre le tue unità di quota API e le tue unità di quota giornaliere di importazione degli intervalli, consulta la sezione Limitazione dell'utilizzo.
Per richiedere un aumento delle tue unità di quota API o delle tue quote giornaliere di importazione degli intervalli, consulta la sezione 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.