# Trace

Source: https://instatus.com/help/it/observability/traces

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](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Trova](https://instatus.com/help/it/observability/traces#trova-richieste-lente-e-con-errori) | status:error, duration:>1s, service: |
| [Apri](https://instatus.com/help/it/observability/traces#apri-una-trace) | Fai clic su una riga per vederne la cascata |
| [Correggi](https://instatus.com/help/it/observability/traces#correggi-una-richiesta-con-errori) | Copia un prompt di correzione per il tuo agente di programmazione |
| [Log](https://instatus.com/help/it/observability/traces#apri-una-trace) | Passa ai log di una richiesta |

Le trace arrivano quando la tua app le invia: spunta **Trace** quando [copi il prompt di configurazione](https://instatus.com/help/it/observability/send-logs#opzione-1-copia-un-prompt), 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](https://instatus.com/help/it/observability/logs#filtra). 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.

![Una trace che attraversa tre servizi, con una chiamata lenta a Okta in fondo alla cascata](https://instatus.com/help/observability/trace-waterfall.png)

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](https://instatus.com/help/observability/trace-error.png)

**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.

- [Metriche](https://instatus.com/help/it/observability/metrics): Individua cosa è cambiato, prima il cambiamento più grande
- [Log](https://instatus.com/help/it/observability/logs): Cerca, filtra e segui in diretta i tuoi log
