Mitä on hajautettu jäljitys ja miten korrelaatiotunnukset toimivat?

Question

Accepted Answer

**Hajautettu jäljitys** seuraa yksittäistä pyyntöä, kun se kulkee useiden palvelujen läpi, jotta näet päästä päähän -polun ja löydät, missä viive tai virheet esiintyvät. **Korrelaatio-/jäljitystunnus** sitoo yhteen yhden pyynnön kaikki span-jakot.

## Kuinka se toimii

Ensimmäinen palvelu luo **jäljitystunnuksen**; jokainen myötävirtaan suuntautuva kutsu lähettää sen eteenpäin (ja vanhempi **span-tunnus**) otsikoissa.

```http
GET /checkout HTTP/1.1
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
# trace-id ───────────────────────────^   ^── span-id
```

```text
Trace abc123:
  Gateway      ├──────────────────────────────┤ 220ms
   Orders        ├────────────┤ 90ms
    Payments        ├──────┤ 60ms   ← slow span found here
    Inventory       ├──┤ 15ms
```

## Mitä se antaa sinulle

- **Viiveen erittely** — mikä palvelu/span on hidas.
- **Virheen paikantaminen** — mikä hyppely epäonnistui.
- **Riippuvuuskartta** — mikä todella kutsuu mitä.

työkalut: OpenTelemetry (instrumentointi), Jaeger / Zipkin (tallennus + UI).

## Sudenkuopat

```text
⚠️ If one service drops the trace header, the trace breaks
⚠️ 100% sampling is expensive — sample, but keep errors
⚠️ Logs are useless across services without the correlation ID attached
```

## Miksi se on tärkeää

Ilman jäljitystä hitaan tai epäonnistuneen pyynnön debuggaus kahdestatoista palvelusta on arvailua; sen avulla näet tarkalleen, mikä hyppely on syyllistynyt.

Korrelaatiotunnuksen levittäminen jokaisen lokirivin ja kutsun läpi on yksittäisen suurimpivaikutuksisen observaatioinvestoinnin mikropalveluarkkitehtuurissa.