Mitä metriikat, lokit ja jäljitykset ovat, ja milloin käytät kutakin?

Question

Accepted Answer

Nämä ovat **havainnointikyky-periaatteen kolme pilaria**. Ne vastaavat eri kysymyksiin: metriikat kertovat sinulle, **että** jokin on vialla, lokit kertovat sinulle, **mitä** tapahtui, ja jäljitykset kertovat sinulle, **minne** hajautetussa prosessissa aika tai virhe meni.

## Kolme pilaria

```text
METRICS  aggregate numbers over time (counters, gauges, histograms)
         → cheap, low cardinality, great for trends & ALERTING
         → e.g. error rate = 2%, p99 latency = 800ms

LOGS     discrete, timestamped events with detail (often structured JSON)
         → rich context for DEBUGGING a specific request
         → e.g. {"level":"error","user":123,"msg":"payment declined"}

TRACES   the path of one request across services, with timing per span
         → shows latency BREAKDOWN and where a call fails
         → e.g. checkout 800ms = api 50ms + db 700ms + email 50ms
```

## Milloin käytät kutakin — yksi poikkeama

```text
1. METRIC alerts: "checkout p99 latency jumped to 2s"   → you know THERE's a problem
2. TRACE a slow request: 1.8s of 2s is spent in the inventory service
                                                        → you know WHERE it is
3. LOGS of the inventory service at that time: "slow query: missing index"
                                                        → you know WHAT happened
```

Metriikat rajaavat sinut oireeseen ja aikaväliksi; jäljitykset paikantavat sen palveluun tai kutsuun; lokit antavat tarkan syyn. Lähteä suoraan lokeihin ilman metriikoita tarkoittaa sokeiden etsimistä.

## Kustannukset ja kardinaalisuus

Metriikat ovat aggregoituja, joten ne pysyvät halvalla jopa suuressa mittakaavassa — ihanteellisia aina käytössä oleville raporttinäytöille ja hälytyksille. Lokit ja jäljitykset ovat tapahtumakohtaisia ja kalliita, joten ne **näytetään yleensä** ja niitä haetaan tarvittaessa tutkimuksen aikana.

## Miksi se on tärkeää

Väärän pilarin käyttäminen tuhlaa aikaa: et voi varoittaa tehokkaasti raakalogista (liian meluisa, liian kallista), eikä voit korjata virheellistä pyyntöä aggregoidusta metriikasta. Se, että tiedät metriikat havaitsevat, jäljitykset paikallistavat ja lokit selittävät, antaa sinulle nopean ja toistettavan polun "jotain on vialla" -tilasta juurisyyhyn asti.