Tá gréine-leathanach nó API mall — conas a aimsíonn tú an chúis?

Question

Accepted Answer

**Ná bíodh barúil agat — tomhais ar dtús.** Is féidir go dtiocfaidh moillearnach ó an chlient, ó an líonra, ó an fhreastalaí, nó ó an bhunbhealach sonraí. Aimsíonn cur chuige ordúil *cá háit* a théann an t-am, ansin deisithe an **rannchuiditheoir is mó** in ionad a bheith ag barrfheabhasú go randamach.

## Seicheamh ordúil

```text
1. MEASURE → where is the time spent? client render, network, server, DB?
2. REPRODUCE → confirm it reliably (same endpoint, payload, user)
3. TRACE → use APM/distributed traces to find the slow span
4. CHECK RECENT CHANGES → deploys, config, traffic, data growth
5. ISOLATE → layer by layer, narrow to one component
6. FIX the biggest contributor → re-measure to confirm
```

## Tomhais ar dtús: cá bhfuil an t-am?

Bain úsáid as an taba **Network/Performance** ar an bhraisteoraí agus **timing** an fhreastalaí chun an iomlán a roinnt. Briseadh úsáideach:

```text
Total 1200ms =
  DNS/connect      20ms
  server TTFB     900ms   ← the bottleneck is server-side
  download         80ms
  client render   200ms
```

Féach ar **céatadáin, ní meánaighearta**: **p50** (úsáideoir gnáth) vs **p99** (an cás is dona). Má tá p50 tapa agat agus p99 mall, tugtar le fios go bhfuil fadhbanna neamhrialta ann — foluain iomaíochta, taisce fuar, mac léinn DB mall, nó sos GC — ní fadhb aonfhoirmeálach.

## Rian an fhréimh mall

Taispeánann uirlisí APM (rian) go díreach cá háit a théann an t-am taobh istigh de iarratas:

```text
GET /orders                       950ms
  ├─ auth check                    10ms
  ├─ SELECT orders                 30ms
  └─ loop: SELECT user per order  900ms   ← N+1 query, the real cause
```

Tugann an rian comhairle dhíreach ar an nglaoch chiontach. Ansin seiceáil **athruithe nua-aimseartha** — dí-imscaradh, innéacs ar iarraidh, nó fás sonraí 10x go minic a mhíníonn cealúchán tobann.

## Cén fáth a bhfuil sé tábhachtach

Goilleann barúil uaireanta an chloig ar bharrfeabhsú ar an sraith bhronach. Nuair a thomhaisíonn tú ar dtús, nuair a rianann tú an réim mall, agus nuair a bhreathnaíonn tú ar **p50 vs p99** casann sé "tá sé mall" i gcoitinne ina chúis ar leith, inchurtha — agus cruthaíonn aththomhas go raibh an leigheas i bhfeidhm i ndáiríre.