Questo documento fornisce un'introduzione alle tracce e agli intervalli. Una traccia rappresenta una singola operazione end-to-end. Le tracce sono composte da span, ovvero record per una singola funzione o operazione.
Modello dei dati Trace
Una traccia ha le seguenti proprietà:
ID traccia: l'identificatore univoco dell'operazione end-to-end. L'ID traccia deve essere propagato come contesto nell'ambito dell'operazione end-to-end.
Una raccolta di span che condividono lo stesso valore per l'ID traccia.
Cloud Trace utilizza l'ID traccia per identificare gli span nel proprio repository associati alla stessa traccia.
Modello dei dati degli intervalli
Un intervallo corrisponde a un'operazione che si è svolta in un periodo di tempo finito, ma non pari a zero. Di seguito sono elencate alcune proprietà essenziali memorizzate da ogni intervallo:
- ID traccia: l'identificatore dell'operazione end-to-end in cui è avvenuta questa particolare operazione complessiva.
- ID intervallo: l'identificatore univoco dell'intervallo. Se la stessa operazione viene invocata più volte per l'esecuzione di una singola operazione complessiva, una traccia potrebbe contenere più span con lo stesso nome. Tuttavia, ogni intervallo ha un ID intervallo distinto.
- ID span principale: identifica l'operazione che ha richiamato questo span. L'intervallo "root" ha l'ID intervallo principale impostato su
null. - Nome: il nome dell'operazione eseguita.
- Ora di inizio: l'ora di inizio dell'operazione.
- Ora di fine: l'ora di fine dell'operazione.
Gli intervalli possono contenere anche attributi, che memorizzano informazioni aggiuntive su un'operazione utilizzando coppie chiave-valore. Cloud Trace consiglia di utilizzare OpenTelemetry Semantic Conventions, se possibile.
Risorse
Risorse OpenTelemetry:
Passaggi successivi
- Scopri di più sul contesto e sulla propagazione del contesto.
- Scopri di più sul campionamento.