# Traces

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

Een trace is één verzoek, gevolgd door elke service die het raakt. Elke stap is een span: een HTTP-aanroep, een databasequery, een aanroep naar een andere service. Traces laten zien waar een traag verzoek zijn tijd aan besteedde en waar een mislukt verzoek fout ging.

Open **Observability** → **Traces** op je statuspagina. Elke rij is één verzoek.

![De traceverkenner met de duur van verzoeken in de tijd en één rij per verzoek](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Vinden](https://instatus.com/help/nl/observability/traces#trage-en-mislukte-verzoeken-vinden) | status:error, duration:>1s, service: |
| [Openen](https://instatus.com/help/nl/observability/traces#een-trace-openen) | Klik op een rij om de waterval te zien |
| [Oplossen](https://instatus.com/help/nl/observability/traces#een-mislukt-verzoek-oplossen) | Een oplossingsprompt voor je codeeragent kopiëren |
| [Logs](https://instatus.com/help/nl/observability/traces#een-trace-openen) | Naar de logs van een verzoek springen |

Traces komen binnen zodra je app ze stuurt: vink **Traces** aan als je [de instelprompt kopieert](https://instatus.com/help/nl/observability/send-logs#optie-1-kopieer-een-prompt), of gebruik auto-instrumentatie.

## De grafiek lezen

Elke stip is een verzoek, geplaatst op tijdstip en duur. Rode stippen zijn mislukt. Boven de grafiek:

- **Traces**: hoeveel verzoeken de zoekopdracht vond.
- **Fouten**: hoeveel er mislukten, en hun aandeel.
- **p50**, **p95**, **p99**: de helft, 95% en 99% van de verzoeken was sneller dan deze waarde.

Sleep in de grafiek om in te zoomen op een tijdvenster.

## Trage en mislukte verzoeken vinden

Gebruik het zoekvak zoals op de pagina [Logs](https://instatus.com/help/nl/observability/logs#filteren). Deze filters zijn gemaakt voor traces:

| Filter          | Vindt                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Verzoeken die mislukten                                |
| `duration:>1s`  | Verzoeken die langer dan een seconde duurden. Ook `>500ms`, `<100ms` |
| `service:api`   | Verzoeken die één service afhandelde                     |
| `span.name:`    | Spans met een bepaalde naam, zoals `GET /v1/users`    |
| Elk kenmerk   | Zoals `http.route:` of `http.response.status_code:` |

Vrije tekst zoekt in spannamen. **Root-spans** staat standaard aan, dus elk verzoek verschijnt één keer. Zet het uit om elke span apart te tonen.

De downloadknop exporteert de lijst als CSV.

## Een trace openen

Klik op een rij. De trace opent met elke span op een tijdlijn, ingesprongen onder de span die hem aanriep. Lange balken laten zien waar de tijd heen ging.

![Een trace door drie services, met een trage aanroep naar Okta onderaan de waterval](https://instatus.com/help/observability/trace-waterfall.png)

In dit voorbeeld duurt het laden van een pagina 842 ms. De waterval laat zien waarom: `web` roept `api` aan, `api` roept `sso` aan, en `sso` wacht 468 ms op Okta.

- Klik op een span om de kenmerken te zien, zoals de route, statuscode of databasequery.
- **N logs van deze span** opent de logs die tijdens die span zijn geschreven.
- **N logs** bovenaan opent elke log van het verzoek, over alle services.
- **Trace-ID kopiëren** kopieert de ID, om te delen of mee te zoeken met `trace_id:`.
- Gebruik **↑** **↓** of **J** **K** om naar de vorige of volgende trace te gaan, en **Esc** om te sluiten.

## Een mislukt verzoek oplossen

Mislukte spans zijn rood. **Alleen fouten** verbergt de spans die werkten, zodat de fout opvalt in een lange trace.

![Een mislukt verzoek met de foutieve spans in rood en een knop om een oplossingsprompt te kopiëren](https://instatus.com/help/observability/trace-error.png)

**Prompt om te fixen kopiëren** kopieert een beschrijving van het mislukte verzoek: de spans, hun fouten en kenmerken. Plak die in je codeeragent, in het project van je app, en die heeft alles om de oorzaak te vinden.

- [Metrics](https://instatus.com/help/nl/observability/metrics): Zien wat er veranderd is, grootste verandering eerst
- [Logs](https://instatus.com/help/nl/observability/logs): Je logs doorzoeken, filteren en live volgen
