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.

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:
| Filtro | Trova |
|---|---|
status:error | Richieste fallite |
duration:>1s | Richieste più lente di un secondo. Anche >500ms, <100ms |
service:api | Richieste gestite da un servizio |
span.name: | Span con un certo nome, come GET /v1/users |
| Qualsiasi attributo | Come 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.

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.

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.