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 tabella seguente riassume le unità di quota disponibili per la lettura e la scrittura
operazioni e la quota giornaliera per l'importazione di intervalli. Ad esempio:
il risultato è un totale di 300 ogni 60 secondi per
i comandi 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. Chiamate a
GetTrace utilizza ListSpan 1 unità della 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
la cronologia dell'account di fatturazione e le richieste di aumento della quota.
Limiti 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 MINIMAL100 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 massimo futuro per un intervallo da importare | 3 giorni |
| Timestamp massimo del passato per l'evento rispetto al timestamp dell'intervallo | 365 giorni |
Puoi annotare gli intervalli creando un oggetto attributes
e di collegarlo all'oggetto Span quando
utilizzi Cloud Trace API v2 batchWrite. Analogamente, puoi annotare intervalli
creando un oggetto labels e collegandolo al
TraceSpan quando utilizzi l'oggetto
Metodo patchTraces dell'Cloud Trace API v1 patchTraces.
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 una modifica di una quota e come monitorare l'utilizzo della quota.
Richiedi modifiche alla quota dell'Cloud Trace API
Puoi richiedere limiti Cloud Trace API superiori o inferiori utilizzando nella console Google Cloud. Per ulteriori informazioni, consulta Visualizzare e gestire le quote.
Se visualizzi l'errore Edit is not allowed for this quota, puoi
contattare l'assistenza per richiedere modifiche a
la quota. Tieni inoltre presente che la fatturazione deve essere abilitata nella
progetto Google Cloud per fare clic sulle caselle di controllo.
Monitorare l'utilizzo delle quote
Per assicurarti di non esaurire la quota e perdere l'osservabilità dei tuoi dati app il rendimento, assicurati di raggruppare gli aggiornamenti e di monitorare l'utilizzo della quota di spazio di archiviazione. Ad esempio, potresti creare un criterio di avviso che quando il tuo utilizzo supera una certa 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 il tuo intervallo giornaliero quote di importazione, consulta Visualizzare e gestire le quote.
Per scoprire come ridurre le unità di quota API e l'intervallo giornaliero unità di quota di importazione, consulta Limitazione dell'utilizzo.
Per richiedere un aumento della quota API: o le tue quote giornaliere di importazione degli intervalli, consulta Richiedi 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.