Questo documento fornisce un'introduzione alle tracce e agli intervalli. Una trace rappresenta una singola operazione end-to-end. Le tracce sono composte da intervalli, che sono record per una singola funzione o operazione.
Modello dei dati di Trace
Una traccia ha le seguenti proprietà:
ID traccia: l'identificatore univoco dell'operazione end-to-end. L'ID traccia deve essere propagato come context nell'ambito dell'operazione end-to-end.
Una raccolta di intervalli che condividono lo stesso valore per l'ID traccia.
Cloud Trace utilizza l'ID traccia per identificare quali intervalli nel suo repository sono associati alla stessa traccia.
Modello dei dati intervallo
Un intervallo corrisponde a un'operazione che si è verificata in un periodo di tempo limitato, ma diverso da zero. Di seguito sono elencate alcune proprietà essenziali archiviate da ogni intervallo:
- ID traccia: l'identificatore dell'operazione end-to-end in cui si è verificata l'operazione complessiva specifica.
- ID intervallo: l'identificatore univoco dell'intervallo. Se la stessa operazione viene richiamata più volte nel fulfillment di una singola operazione complessiva, una traccia potrebbe contenere più intervalli con lo stesso nome. Tuttavia, ogni intervallo ha un proprio ID.
- ID intervallo padre: identifica l'operazione che ha richiamato l'intervallo. L'intervallo "root" ha l'ID dell'intervallo padre impostato su
null. - Nome: il nome dell'operazione eseguita.
- Start time (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 ulteriori informazioni su un'operazione utilizzando coppie chiave-valore. Cloud Trace consiglia di utilizzare le convenzioni semantiche di OpenTelemetry ove possibile.
Risorse
Risorse OpenTelemetry:
Passaggi successivi
- Scopri di più sulla propagazione del contesto e del contesto.
- Ulteriori informazioni sul campionamento.