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.

Traces komen binnen zodra je app ze stuurt: vink Traces aan als je de instelprompt kopieert, 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. 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.

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.

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.