# Trace-uri

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

Un trace este o cerere, urmărită prin fiecare serviciu pe care îl atinge. Fiecare pas este un span: un apel HTTP, o interogare a bazei de date, un apel către alt serviciu. Trace-urile îți arată unde și-a petrecut timpul o cerere lentă și unde s-a stricat una eșuată.

Deschide **Observability** → **Trace-uri** pe pagina ta de status. Fiecare rând este o cerere.

![Exploratorul de trace-uri, cu durata cererilor în timp și un rând pentru fiecare cerere](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Găsește](https://instatus.com/help/ro/observability/traces#găsește-cererile-lente-și-eșuate) | status:error, duration:>1s, service: |
| [Deschide](https://instatus.com/help/ro/observability/traces#deschide-un-trace) | Dă clic pe un rând ca să vezi cascada |
| [Repară](https://instatus.com/help/ro/observability/traces#repară-o-cerere-eșuată) | Copiază un prompt de reparare pentru agentul tău de programare |
| [Loguri](https://instatus.com/help/ro/observability/traces#deschide-un-trace) | Sari la logurile unei cereri |

Trace-urile sosesc imediat ce aplicația le trimite: bifează **Trace-uri** când [copiezi promptul de configurare](https://instatus.com/help/ro/observability/send-logs#opțiunea-1-copiază-un-prompt), sau folosește instrumentarea automată.

## Citește graficul

Fiecare punct este o cerere, așezat după momentul în care a avut loc și cât a durat. Punctele roșii au eșuat. Deasupra graficului:

- **Trace-uri**: câte cereri a găsit căutarea.
- **Erori**: câte au eșuat și ce proporție reprezintă.
- **p50**, **p95**, **p99**: jumătate, 95% și 99% dintre cereri au fost mai rapide decât această valoare.

Trage pe grafic ca să mărești o fereastră de timp.

## Găsește cererile lente și eșuate

Folosește caseta de căutare ca pe pagina [Loguri](https://instatus.com/help/ro/observability/logs#filtrează). Aceste filtre sunt create pentru trace-uri:

| Filtru          | Găsește                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Cererile care au eșuat                                |
| `duration:>1s`  | Cererile mai lente de o secundă. Și `>500ms`, `<100ms` |
| `service:api`   | Cererile gestionate de un serviciu                     |
| `span.name:`    | Span-urile cu un anumit nume, de exemplu `GET /v1/users`    |
| Orice atribut   | De exemplu `http.route:` sau `http.response.status_code:` |

Textul liber caută în numele span-urilor. **Span-uri rădăcină** este activat implicit, așa că fiecare cerere apare o dată. Dezactivează-l ca să vezi fiecare span separat.

Butonul de descărcare exportă lista în CSV.

## Deschide un trace

Dă clic pe un rând. Trace-ul se deschide cu fiecare span pe o axă a timpului, imbricat sub span-ul care l-a apelat. Barele lungi arată unde s-a dus timpul.

![Un trace prin trei servicii, cu un apel lent către Okta în partea de jos a cascadei](https://instatus.com/help/observability/trace-waterfall.png)

În acest exemplu, încărcarea unei pagini durează 842 ms. Cascada arată de ce: `web` apelează `api`, `api` apelează `sso`, iar `sso` așteaptă 468 ms după Okta.

- Dă clic pe un span ca să-i vezi atributele, de exemplu ruta, codul de stare sau interogarea bazei de date.
- **N de loguri din acest span** deschide logurile scrise în timpul acelui span.
- **N de loguri** din partea de sus deschide fiecare log al cererii, în toate serviciile.
- **Copiază ID-ul trace-ului** copiază ID-ul, ca să-l partajezi sau să cauți cu `trace_id:`.
- Folosește **↑** **↓** sau **J** **K** ca să treci la trace-ul anterior sau următor și **Esc** ca să închizi.

## Repară o cerere eșuată

Span-urile eșuate sunt roșii. **Doar erori** ascunde span-urile care au funcționat, ca eroarea să iasă în evidență într-un trace lung.

![O cerere eșuată, cu span-urile cu erori în roșu și un buton pentru copierea unui prompt de reparare](https://instatus.com/help/observability/trace-error.png)

**Copiază promptul de remediere** copiază o descriere a cererii eșuate: span-urile, erorile și atributele lor. Lipește-o în agentul tău de programare, în proiectul aplicației, și va avea tot ce-i trebuie ca să găsească cauza.

- [Metrici](https://instatus.com/help/ro/observability/metrics): Observă ce s-a schimbat, cea mai mare schimbare prima
- [Loguri](https://instatus.com/help/ro/observability/logs): Caută, filtrează și urmărește logurile live
