Cilat janë metrikat, regjistrat dhe gjurmët, dhe kur i përdorni secilën?

Question

Accepted Answer

Këto janë **tre shtyllat e vëzhgueshmërisë**. Ata përgjigjen pyetjeve të ndryshme: metrikat ju thonë **që** diçka është e gabuar, regjistrat ju thonë **çfarë** ndodhi, dhe gjurmët ju thonë **ku** në rrjedhën e shpërndarë shkoi koha ose gabimi.

## Tre shtyllat

```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
```

## Kur të përdorni secilën — një incident

```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
```

Metrikat ju ngushtojnë në një simptom dhe dritare kohore; gjurmët e lokalizojnë atë në një shërbim ose thirrje; regjistrat japin shkakun e saktë. Të shkosh drejtë te regjistrat pa metrika do të thotë të kërkosh verbërisht.

## Kostoja dhe kardinaliteti

Metrikat agregojnë, kështu që mbeten të lira edhe në shkallë — ideale për panele kontrolli dhe alarme gjithmonë aktive. Regjistrat dhe gjurmët janë për-event dhe të shtrenjtë, kështu që zakonisht **makinohen** dhe kërkohen në kërkesë gjatë hetimit.

## Pse është e rëndësishme

Përdorimi i shtyllës së gabuar dëmton kohën: nuk mund të lajmërojë në mënyrë efektive në regjistrat e papërpunuar (shumë të zhurmshëm, shumë të shtrenjtë), dhe nuk mund të rafinoj një kërkesë të dështuar specifike nga një metrikë agregate. Të dije që metrikat zbulojnë, gjurmët lokalizojnë dhe regjistrat shpjegojnë të jep një rrugë të shpejtë, të përsëritshme nga "diçka është e gabuar" deri te shkaku i rrënjës.