Trace

Una trace è una richiesta, seguita attraverso ogni servizio che tocca. Ogni passaggio è uno span: una chiamata HTTP, una query al database, una chiamata a un altro servizio. Le trace ti mostrano dove una richiesta lenta ha speso il suo tempo e dove una richiesta con errori si è interrotta.

Apri Observability → Trace sulla tua pagina di stato. Ogni riga è una richiesta.

L’esploratore delle trace, con la durata delle richieste nel tempo e una riga per richiesta

Le trace arrivano quando la tua app le invia: spunta Trace quando copi il prompt di configurazione, oppure usa l’auto-strumentazione.

Leggi il grafico

Ogni punto è una richiesta, posizionata in base a quando è avvenuta e quanto è durata. I punti rossi sono falliti. Sopra il grafico:

  • Trace: quante richieste ha trovato la ricerca.
  • Errori: quante sono fallite e la loro quota.
  • p50, p95, p99: la metà, il 95% e il 99% delle richieste sono state più veloci di questo valore.

Trascina sul grafico per ingrandire una finestra di tempo.

Trova richieste lente e con errori

Usa la casella di ricerca come nella pagina Log. Questi filtri sono pensati per le trace:

FiltroTrova
status:errorRichieste fallite
duration:>1sRichieste più lente di un secondo. Anche >500ms, <100ms
service:apiRichieste gestite da un servizio
span.name:Span con un certo nome, come GET /v1/users
Qualsiasi attributoCome http.route: o http.response.status_code:

Il testo libero cerca nei nomi degli span. Span radice è attivo per impostazione predefinita, quindi ogni richiesta compare una volta. Disattivalo per elencare ogni span separatamente.

Il pulsante di download esporta l’elenco in CSV.

Apri una trace

Fai clic su una riga. La trace si apre con ogni span su una linea del tempo, annidato sotto lo span che lo ha chiamato. Le barre lunghe mostrano dove è finito il tempo.

Una trace che attraversa tre servizi, con una chiamata lenta a Okta in fondo alla cascata

In questo esempio il caricamento di una pagina richiede 842 ms. La cascata mostra il perché: web chiama api, api chiama sso e sso attende Okta per 468 ms.

  • Fai clic su uno span per vederne gli attributi, come la route, il codice di stato o la query al database.
  • N log da questo span apre i log scritti durante quello span.
  • N log in alto apre ogni log della richiesta, in tutti i servizi.
  • Copia ID trace copia l’ID, per condividerlo o cercarlo con trace_id:.
  • Usa ↑ ↓ o J K per passare alla trace precedente o successiva, ed Esc per chiudere.

Correggi una richiesta con errori

Gli span falliti sono rossi. Solo errori nasconde quelli andati a buon fine, così l’errore risalta in una trace lunga.

Una richiesta fallita, con gli span in errore in rosso e un pulsante per copiare un prompt di correzione

Copia prompt per correggere copia una descrizione della richiesta fallita: gli span, i loro errori e attributi. Incollala nel tuo agente di programmazione, nel progetto della tua app, e avrà ciò che serve per trovare la causa.