Trace

Definizione rapida

Registrazione ordinata del percorso seguito da una richiesta o da un agente, comprese operazioni, strumenti, risultati ed errori.

Spiegazione

Una trace collega passaggi distribuiti tramite identificativi e rende visibile dove si è consumato tempo o quale decisione ha prodotto un esito. I dati devono essere minimizzati e protetti perché possono contenere informazioni sensibili.

Esempio pratico

Una richiesta AI mostra recupero documenti, chiamata al modello, validazione e risposta finale con durata e stato di ogni span.

Spiegazione tecnica

La traccia è composta da span correlati, attributi, eventi e contesto di propagazione; sampling e retention regolano costo e conservazione.

Da non confondere con

Non è un log isolato: la trace ricostruisce una sequenza correlata attraverso componenti diversi.