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 le operazioni di lettura e scrittura e la quota giornaliera per l'importazione degli span. Ad esempio,
hai un totale di 300 per 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 consumano ListSpan 1 unità di quota.
2 Le operazioni di scrittura includono PatchTraces, BatchWrite e CreateSpan. Ogni operazione di scrittura consuma 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 di Trace
Questa sezione elenca i limiti che si applicano all'utilizzo dell'Cloud Trace API.
Limiti per i metodi dell'API
| Limiti per i metodi dell'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 nelle visualizzazioni ROOTSPAN e MINIMAL100 nella visualizzazione COMPLETE |
Limiti per gli intervalli
| Limiti per gli 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 passato massimo per un intervallo da importare | 14 giorni |
| Timestamp futuro massimo per un intervallo da importare | 3 giorni |
| Timestamp passato massimo per l'evento rispetto 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 della versione 1 dell'Cloud Trace API.
Limiti per le tracce
| Limiti per le tracce | Valore |
|---|---|
| Numero massimo di intervalli per traccia | 1000 |
| Dimensione massima della traccia | 50 MB |
Periodi di conservazione di Trace
| Categoria | Periodo di conservazione |
|---|---|
| Dati degli intervalli archiviati da Cloud Trace | 30 giorni |
| Rapporti di analisi | 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 per l'Cloud Trace API
Puoi richiedere limiti superiori o inferiori per l'Cloud Trace API utilizzando la console Google Cloud. Per ulteriori informazioni, vedi Visualizzare e gestire le quote.
Se ricevi un 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 è necessario che la fatturazione sia attivata nel progetto Google 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 unità di quota API e le 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 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.