# Traces

Source: https://instatus.com/help/de/observability/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.

![Der Trace-Explorer mit den Anfragedauern über die Zeit und einer Zeile pro Anfrage](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Finden](https://instatus.com/help/de/observability/traces#langsame-und-fehlerhafte-anfragen-finden) | status:error, duration:>1s, service: |
| [Öffnen](https://instatus.com/help/de/observability/traces#einen-trace-öffnen) | Auf eine Zeile klicken, um ihren Wasserfall zu sehen |
| [Beheben](https://instatus.com/help/de/observability/traces#eine-fehlerhafte-anfrage-beheben) | Einen Prompt zur Behebung für Ihren Coding-Agenten kopieren |
| [Logs](https://instatus.com/help/de/observability/traces#einen-trace-öffnen) | Zu den Logs einer Anfrage springen |

Traces kommen an, sobald Ihre App sie sendet: Wählen Sie **Traces**, wenn Sie [den Einrichtungs-Prompt kopieren](https://instatus.com/help/de/observability/send-logs#weg-1-einen-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](https://instatus.com/help/de/observability/logs#filtern). 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.

![Ein Trace über drei Dienste mit einem langsamen Aufruf an Okta unten im Wasserfall](https://instatus.com/help/observability/trace-waterfall.png)

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.

![Eine fehlgeschlagene Anfrage mit den fehlerhaften Spans in Rot und einer Schaltfläche zum Kopieren eines Prompts zur Behebung](https://instatus.com/help/observability/trace-error.png)

**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.

- [Metriken](https://instatus.com/help/de/observability/metrics): Erkennen, was sich geändert hat, größte Änderung zuerst
- [Logs](https://instatus.com/help/de/observability/logs): Logs durchsuchen, filtern und live verfolgen
