# Jäljet

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

Jälki on yksi pyyntö, jota seurataan jokaisen palvelun läpi, jota se koskettaa. Jokainen vaihe on span: HTTP-kutsu, tietokantakysely, kutsu toiseen palveluun. Jäljet näyttävät, mihin hidas pyyntö käytti aikansa ja missä epäonnistunut pyyntö hajosi.

Avaa **Observability** → **Jäljet** tilasivullasi. Jokainen rivi on yksi pyyntö.

![Jälkiselain, jossa pyyntöjen kestot ajan mittaan ja yksi rivi pyyntöä kohden](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Etsi](https://instatus.com/help/fi/observability/traces#löydä-hitaat-ja-epäonnistuneet-pyynnöt) | status:error, duration:>1s, service: |
| [Avaa](https://instatus.com/help/fi/observability/traces#avaa-jälki) | Napsauta riviä nähdäksesi vesiputouksen |
| [Korjaa](https://instatus.com/help/fi/observability/traces#korjaa-epäonnistunut-pyyntö) | Kopioi korjauskehote koodausagentillesi |
| [Lokit](https://instatus.com/help/fi/observability/traces#avaa-jälki) | Siirry pyynnön lokeihin |

Jäljet saapuvat, kun sovelluksesi lähettää niitä: valitse **Jäljet**, kun [kopioit asetuskehotteen](https://instatus.com/help/fi/observability/send-logs#tapa-1-kopioi-kehote), tai käytä automaattista instrumentointia.

## Lue kaavio

Jokainen piste on pyyntö, sijoitettuna ajankohdan ja keston mukaan. Punaiset pisteet epäonnistuivat. Kaavion yläpuolella:

- **Jäljet**: montako pyyntöä haku löysi.
- **Virheet**: montako epäonnistui ja niiden osuus.
- **p50**, **p95**, **p99**: puolet, 95 % ja 99 % pyynnöistä oli tätä nopeampia.

Vedä kaavion yli lähentääksesi aikaikkunaan.

## Löydä hitaat ja epäonnistuneet pyynnöt

Käytä hakukenttää kuten sivulla [Lokit](https://instatus.com/help/fi/observability/logs#suodata). Nämä suodattimet on tehty jäljille:

| Suodatin          | Löytää                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Epäonnistuneet pyynnöt                                |
| `duration:>1s`  | Yli sekunnin kestäneet pyynnöt. Myös `>500ms`, `<100ms` |
| `service:api`   | Yhden palvelun käsittelemät pyynnöt                     |
| `span.name:`    | Tietyn nimiset spanit, esimerkiksi `GET /v1/users`    |
| Mikä tahansa määrite   | Esimerkiksi `http.route:` tai `http.response.status_code:` |

Vapaa teksti hakee spanien nimistä. **Juurispanit** on oletuksena päällä, joten jokainen pyyntö näkyy kerran. Kytke se pois listataksesi jokaisen spanin erikseen.

Latauspainike vie luettelon CSV-muodossa.

## Avaa jälki

Napsauta riviä. Jälki avautuu, ja jokainen span näkyy aikajanalla sisennettynä sen spanin alle, joka kutsui sitä. Pitkät palkit näyttävät, mihin aika kului.

![Kolmen palvelun läpi kulkeva jälki, jonka vesiputouksen alaosassa on hidas kutsu Oktaan](https://instatus.com/help/observability/trace-waterfall.png)

Tässä esimerkissä sivun lataus kestää 842 ms. Vesiputous näyttää miksi: `web` kutsuu palvelua `api`, `api` kutsuu palvelua `sso`, ja `sso` odottaa Oktaa 468 ms.

- Napsauta spania nähdäksesi sen määritteet, kuten reitin, tilakoodin tai tietokantakyselyn.
- **N lokia tästä spanista** avaa spanin aikana kirjoitetut lokit.
- Yläreunan **N lokia** avaa pyynnön jokaisen lokin kaikista palveluista.
- **Kopioi jäljen tunnus** kopioi tunnuksen jaettavaksi tai haettavaksi suodattimella `trace_id:`.
- Siirry edelliseen tai seuraavaan jälkeen nuolilla **↑** **↓** tai **J** **K**, ja sulje näppäimellä **Esc**.

## Korjaa epäonnistunut pyyntö

Epäonnistuneet spanit ovat punaisia. **Vain virheet** piilottaa onnistuneet spanit, jotta virhe erottuu pitkässä jäljessä.

![Epäonnistunut pyyntö, jonka virheelliset spanit ovat punaisia, ja painike korjauskehotteen kopioimiseen](https://instatus.com/help/observability/trace-error.png)

**Kopioi korjauskehote** kopioi kuvauksen epäonnistuneesta pyynnöstä: spanit, niiden virheet ja määritteet. Liitä se koodausagenttiisi sovelluksesi projektissa, niin sillä on kaikki, mitä se tarvitsee syyn löytämiseen.

- [Metriikat](https://instatus.com/help/fi/observability/metrics): Huomaa, mikä muuttui, suurin muutos ensin
- [Lokit](https://instatus.com/help/fi/observability/logs): Hae, suodata ja seuraa lokeja suorana
