Tracce e intervalli

In Cloud Trace, le tracce e gli intervalli formano il modello dei dati utilizzato per monitorare il percorso e la latenza delle richieste nelle applicazioni distribuite. Una traccia acquisisce il modo in cui una richiesta viene eseguita end-to-end nei tuoi servizi. Una traccia è composta da intervalli, che registrano le singole operazioni, le chiamate di funzioni e gli RPC che si verificano durante la richiesta.

Modello dei dati di Trace

Una traccia è composta da:

  • ID traccia: l'identificatore univoco dell'operazione end-to-end. L'ID traccia viene propagato nel contesto della richiesta tra i limiti dei servizi.

  • Raccolta di intervalli: un insieme di intervalli che condividono lo stesso ID traccia. Questi intervalli formano un albero o un grafo diretto aciclico che rappresenta la gerarchia delle chiamate di una richiesta.

Cloud Trace utilizza l'ID traccia per identificare gli intervalli nel suo repository associati alla stessa traccia.

Modello dei dati degli intervalli

Un intervallo rappresenta una singola operazione avvenuta in un periodo di tempo specifico. Ogni intervallo contiene campi che forniscono informazioni sull'intervallo e sullo stato dell'operazione:

  • Gli identificatori includono i seguenti campi:

    • ID traccia: l'identificatore univoco della richiesta o della traccia complessiva a cui appartiene l'intervallo.
    • ID intervallo: l'identificatore univoco dell'intervallo. Se un'operazione viene richiamata più volte all'interno di una singola traccia, ogni chiamata genera un intervallo separato con lo stesso nome, ma con un ID intervallo univoco.
    • ID intervallo principale: identifica l'operazione principale che ha richiamato questo intervallo. L'intervallo "root" ha l'ID intervallo principale impostato su null.
    • Nome: il nome dell'operazione eseguita.
    • Tipo: il tipo di intervallo fornisce informazioni agli strumenti di tracciamento, come Trace Explorer, su come gli intervalli sono correlati tra loro. Per ulteriori informazioni, consulta OpenTelemetry SpanKind.

  • Le informazioni sull'esecuzione sono fornite nei seguenti campi:

    • Stato: registra lo stato di completamento dell'operazione. Il valore di questo campo è Unset (valore predefinito), Error o Ok. Il valore predefinito non indica un errore.
    • Ora di inizio: l'ora di inizio dell'operazione.
    • Ora di fine: l'ora di fine dell'operazione.

Gli intervalli possono contenere altri campi, come eventi, attributi e link:

  • Gli eventi registrano messaggi strutturati con timestamp all'interno di un intervallo.
  • Gli attributi memorizzano informazioni aggiuntive su un'operazione utilizzando coppie chiave-valore. Quando scrivi gli attributi, ti consigliamo di seguire le convenzioni semantiche di OpenTelemetry, se possibile.
  • I link consentono di mettere in relazione un intervallo con un altro.

Per ulteriori informazioni, consulta OpenTelemetry: Spans.

Risorse

Risorse OpenTelemetry:

Passaggi successivi