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

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:

FilterVindt
status:errorVerzoeken die mislukten
duration:>1sVerzoeken die langer dan een seconde duurden. Ook >500ms, <100ms
service:apiVerzoeken die één service afhandelde
span.name:Spans met een bepaalde naam, zoals GET /v1/users
Elk kenmerkZoals 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

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

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.