Cloud Trace applica due diversi tipi di quote: una quota di frequenza per le richieste API e una quota di importazione per gli intervalli inviati a Trace.
Quote di Trace
La seguente tabella riassume le unità di quota disponibili per le operazioni di lettura e scrittura e la quota giornaliera per l'importazione degli intervalli. Ad esempio,
il 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
ListTraces
ogni 60 secondi. - Puoi eseguire 10 chiamate API
ListTraces
e 50 chiamate APIGetTrace
ogni 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
consuma 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 La quota giornaliera di importazione degli intervalli di traccia è determinata dalla cronologia dell'account di fatturazione e dalle richieste effettuate per incrementare la quota.
Limiti di Trace
Questa sezione elenca i limiti che si applicano quando si utilizza l'Cloud Trace API.
Limiti per i metodi API
Limiti per i metodi API | 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 nella visualizzazione ROOTSPAN e MINIMAL 100 nella visualizzazione COMPLETE |
Limiti degli intervalli
Limiti degli intervalli | Valore |
---|---|
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 massimo passato per un intervallo da importare | 14 giorni |
Timestamp futuro massimo per un intervallo da importare | 3 giorni |
Timestamp massimo passato per l'evento in relazione al timestamp dell'intervallo | 365 giorni |
Puoi annotare gli intervalli creando un oggetto attributes
e collegandolo all'oggetto Span
quando utilizzi l'Cloud Trace API v2 batchWrite
. Analogamente, puoi annotare gli intervalli creando un oggetto labels
e collegandolo all'oggetto TraceSpan
quando utilizzi il metodo patchTraces
dell'Cloud Trace API v1.
Limiti delle tracce
Limiti delle tracce | Valore |
---|---|
Numero massimo di intervalli per traccia | 1000 |
Dimensione massima della traccia | 50 MB |
Periodi di conservazione di Trace
Categoria | Periodo di conservazione |
---|---|
Intervalli di dati archiviati da Cloud Trace | 30 giorni |
Rapporti di analisi | 30 giorni |
Gestisci la tua quota
Questa sezione descrive come richiedere la modifica di una quota e come monitorare l'utilizzo della quota.
Richiedi modifiche alla quota dell'Cloud Trace API
Puoi richiedere limiti più o meno elevati per l'Cloud Trace API utilizzando la console Google Cloud:
Nella pagina Quote della console Google Cloud, utilizza le caselle di controllo per selezionare API Cloud Trace, quindi fai clic su Modifica quote.
Se visualizzi un messaggio di errore
Edit is not allowed for this quota
, puoi contattare l'assistenza per richiedere modifiche alla quota. Tieni inoltre presente che per poter selezionare le caselle di controllo devi attivare la fatturazione nel progetto Google Cloud.Nel riquadro Modifiche alle quote, seleziona il servizio per espandere la visualizzazione, poi compila i campi Nuovo limite e Richiedi descrizione. Fai clic su Avanti.
Compila il modulo nel riquadro Informazioni di contatto.
Fai clic su Invia richiesta.
Per maggiori informazioni, vedi Visualizzare e gestire le quote.
Monitora l'utilizzo della quota
Per evitare di esaurire la quota e perdere osservabilità sulle prestazioni delle app, assicurati di raggruppare gli aggiornamenti e di monitorare l'utilizzo della quota. Ad esempio, potresti creare un criterio di avviso che ti avvisa quando il tuo utilizzo supera una determinata 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 degli intervalli, consulta Visualizzare e gestire le quote.
Per informazioni su come ridurre le unità di quota API e le unità di quota giornaliera di importazione degli intervalli, consulta Limitazione dell'utilizzo.
Per richiedere un aumento delle unità di quota API o delle quote giornaliere di importazione degli intervalli, 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.