# Ślady

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

Ślad to jedno żądanie, śledzone przez każdą usługę, której dotyka. Każdy krok to span: wywołanie HTTP, zapytanie do bazy danych, wywołanie innej usługi. Ślady pokazują, na co wolne żądanie straciło czas i gdzie nieudane się zepsuło.

Otwórz **Observability** → **Ślady** na swojej stronie statusu. Każdy wiersz to jedno żądanie.

![Eksplorator śladów z czasem trwania żądań w czasie i jednym wierszem na żądanie](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Szukanie](https://instatus.com/help/pl/observability/traces#znajdź-wolne-i-nieudane-żądania) | status:error, duration:>1s, service: |
| [Otwieranie](https://instatus.com/help/pl/observability/traces#otwórz-ślad) | Kliknij wiersz, by zobaczyć kaskadę |
| [Naprawa](https://instatus.com/help/pl/observability/traces#napraw-nieudane-żądanie) | Skopiuj prompt do naprawy dla agenta programistycznego |
| [Logi](https://instatus.com/help/pl/observability/traces#otwórz-ślad) | Przejdź do logów żądania |

Ślady pojawiają się, gdy aplikacja zacznie je wysyłać: zaznacz **Ślady** podczas [kopiowania promptu konfiguracji](https://instatus.com/help/pl/observability/send-logs#sposób-1-skopiuj-prompt) albo użyj automatycznej instrumentacji.

## Czytanie wykresu

Każda kropka to żądanie, umieszczone według czasu i długości trwania. Czerwone kropki się nie powiodły. Nad wykresem:

- **Ślady**: ile żądań znalazło wyszukiwanie.
- **Błędy**: ile się nie powiodło i jaki to odsetek.
- **p50**, **p95**, **p99**: połowa, 95% i 99% żądań było szybszych niż ta wartość.

Przeciągnij po wykresie, by przybliżyć okno czasu.

## Znajdź wolne i nieudane żądania

Używaj pola wyszukiwania jak na stronie [Logi](https://instatus.com/help/pl/observability/logs#filtrowanie). Te filtry są przeznaczone dla śladów:

| Filtr          | Znajduje                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Żądania, które się nie powiodły                                |
| `duration:>1s`  | Żądania wolniejsze niż sekunda. Także `>500ms`, `<100ms` |
| `service:api`   | Żądania obsłużone przez jedną usługę                     |
| `span.name:`    | Spany o danej nazwie, np. `GET /v1/users`    |
| Dowolny atrybut   | Np. `http.route:` lub `http.response.status_code:` |

Wyszukiwanie tekstowe przeszukuje nazwy spanów. **Spany główne** jest domyślnie włączone, więc każde żądanie pojawia się raz. Wyłącz je, by zobaczyć każdy span osobno.

Przycisk pobierania eksportuje listę do CSV.

## Otwórz ślad

Kliknij wiersz. Ślad otworzy się z każdym spanem na osi czasu, zagnieżdżonym pod spanem, który go wywołał. Długie paski pokazują, gdzie poszedł czas.

![Ślad przechodzący przez trzy usługi, z wolnym wywołaniem Okta na dole kaskady](https://instatus.com/help/observability/trace-waterfall.png)

W tym przykładzie wczytanie strony trwa 842 ms. Kaskada pokazuje dlaczego: `web` wywołuje `api`, `api` wywołuje `sso`, a `sso` czeka 468 ms na Okta.

- Kliknij span, by zobaczyć jego atrybuty, np. trasę, kod statusu lub zapytanie do bazy danych.
- **N logu z tego spanu** otwiera logi zapisane w trakcie tego spanu.
- **N logu** na górze otwiera każdy log żądania, we wszystkich usługach.
- **Kopiuj ID śladu** kopiuje identyfikator, by go udostępnić lub wyszukać przez `trace_id:`.
- Użyj **↑** **↓** lub **J** **K**, by przejść do poprzedniego lub następnego śladu, i **Esc**, by zamknąć.

## Napraw nieudane żądanie

Nieudane spany są czerwone. **Tylko błędy** ukrywa te, które zadziałały, by błąd wyróżniał się w długim śladzie.

![Nieudane żądanie z błędnymi spanami na czerwono i przyciskiem kopiowania promptu do naprawy](https://instatus.com/help/observability/trace-error.png)

**Kopiuj prompt do naprawy** kopiuje opis nieudanego żądania: spany, ich błędy i atrybuty. Wklej go do agenta programistycznego w projekcie aplikacji, a będzie miał wszystko, by znaleźć przyczynę.

- [Metryki](https://instatus.com/help/pl/observability/metrics): Zauważ, co się zmieniło, największa zmiana na górze
- [Logi](https://instatus.com/help/pl/observability/logs): Przeszukuj, filtruj i śledź logi na żywo
