Traces
Ein Trace ist eine Anfrage, verfolgt durch jeden Dienst, den sie berührt. Jeder Schritt ist ein Span: ein HTTP-Aufruf, eine Datenbankabfrage, ein Aufruf an einen anderen Dienst. Traces zeigen Ihnen, wo eine langsame Anfrage ihre Zeit verbracht hat und wo eine fehlerhafte abgebrochen ist.
Öffnen Sie Observability → Traces auf Ihrer Statusseite. Jede Zeile ist eine Anfrage.

Traces kommen an, sobald Ihre App sie sendet: Wählen Sie Traces, wenn Sie den Einrichtungs-Prompt kopieren, oder nutzen Sie Auto-Instrumentierung.
Das Diagramm lesen
Jeder Punkt ist eine Anfrage, platziert nach Zeitpunkt und Dauer. Rote Punkte sind fehlgeschlagen. Über dem Diagramm:
- Traces: wie viele Anfragen die Suche gefunden hat.
- Fehler: wie viele fehlgeschlagen sind, und ihr Anteil.
- p50, p95, p99: die Hälfte, 95 % und 99 % der Anfragen waren schneller als dieser Wert.
Ziehen Sie im Diagramm, um in ein Zeitfenster zu zoomen.
Langsame und fehlerhafte Anfragen finden
Nutzen Sie das Suchfeld wie auf der Seite Logs. Diese Filter sind für Traces gemacht:
| Filter | Findet |
|---|---|
status:error | Fehlgeschlagene Anfragen |
duration:>1s | Anfragen, die länger als eine Sekunde dauern. Auch >500ms, <100ms |
service:api | Anfragen, die ein Dienst bearbeitet hat |
span.name: | Spans mit einem bestimmten Namen, etwa GET /v1/users |
| Jedes Attribut | Etwa http.route: oder http.response.status_code: |
Freitext durchsucht Span-Namen. Root-Spans ist standardmäßig an, jede Anfrage erscheint also einmal. Schalten Sie es aus, um jeden Span einzeln aufzulisten.
Die Download-Schaltfläche exportiert die Liste als CSV.
Einen Trace öffnen
Klicken Sie auf eine Zeile. Der Trace öffnet sich mit jedem Span auf einer Zeitleiste, eingerückt unter dem Span, der ihn aufgerufen hat. Lange Balken zeigen, wohin die Zeit ging.

In diesem Beispiel dauert ein Seitenaufruf 842 ms. Der Wasserfall zeigt warum: web ruft api auf, api ruft sso auf, und sso wartet 468 ms auf Okta.
- Klicken Sie auf einen Span, um seine Attribute zu sehen, etwa Route, Statuscode oder Datenbankabfrage.
- N Logs aus diesem Span öffnet die Logs, die während dieses Spans geschrieben wurden.
- N Logs oben öffnet jedes Log der Anfrage, über alle Dienste hinweg.
- Trace-ID kopieren kopiert die ID, zum Teilen oder zum Suchen mit
trace_id:. - Mit ↑ ↓ oder J K gehen Sie zum vorherigen oder nächsten Trace, mit Esc schließen Sie.
Eine fehlerhafte Anfrage beheben
Fehlgeschlagene Spans sind rot. Nur Fehler blendet die Spans aus, die funktioniert haben, damit der Fehler in einem langen Trace hervorsticht.

Prompt zum Beheben kopieren kopiert eine Beschreibung der fehlerhaften Anfrage: die Spans, ihre Fehler und Attribute. Fügen Sie sie in Ihren Coding-Agenten ein, im Projekt Ihrer App, und er hat alles, um die Ursache zu finden.