Conas a chuireann tú clogging agus monatóireacht i bhfeidhm i Node táirgheachta?

Question

Accepted Answer

**Clogging** a dhéanann taifead ar an méid a dhéanann do app; **monatóireacht** a rianann a sláinte agus a thairbhí. Le chéile tugann siad **infhéachaint** duit — an cumas a bheith tuisceanach agus fabht a bhaint as córas táirgheachta atá ag rith. Níl `console.log` leordhóthanach ar son seo; tá ní níos sruthdhronach agat ag teastáil, tomhais, agus fógra.

## Clogging sruthdhronach (ní console.log)

```js
import pino from "pino";
const logger = pino();

// ✅ structured JSON logs — machine-parseable, searchable, with context
logger.info({ userId: 123, action: "login", ip: req.ip }, "user logged in");
logger.error({ err, requestId }, "failed to process order");
```

Usáid logger sruthdhronach (pino/winston) a fhógraíonn **JSON** le réimsí comhsheasmhach. Tá JSON logs indhóthain agus intuigthe i dtúis log aggregation, murab ionann agus teaghráin saor-fhoirm `console.log`. Áireamh comhthéacs (user id, request id) ar gach log.

## Leibhéal log agus céard atá le logáil

```text
Levels: error > warn > info > debug (configure threshold per environment)
Log:    requests, errors with stack traces, key business events, slow operations
DON'T log: passwords, tokens, PII, full payloads with secrets (security/privacy)
```

## Léiríonn Correlation IDs iarratas trasna seirbhísí

```js
// attach a unique id per request, include it in EVERY log for that request
app.use((req, res, next) => {
  req.id = crypto.randomUUID();
  res.setHeader("X-Request-Id", req.id);
  next();
});
// now you can filter all logs for one request — vital in microservices
```

Ligann **correlation/request ID** duit an scéal iomlán a atógáil ar iarratas amháin, fiú trasna seirbhísí iolracha — neamhriachtanach do dheasca a dhíbirt córais dáileadh.

## Lárnóidh logs

```text
Ship logs to a central platform (ELK/Elasticsearch, Datadog, Grafana Loki, CloudWatch)
→ search/aggregate across all instances; don't grep files on individual servers.
```

## Monatóireacht: tomhais, fógra, rianú

```text
Metrics:  request rate, error rate, latency (p50/p95/p99), CPU/memory, event-loop lag
          (often via Prometheus + Grafana, or an APM like Datadog/New Relic)
Health:   /health & /ready endpoints for load balancers and orchestrators
Alerting: notify (PagerDuty/Slack) when error rate spikes or latency degrades
Tracing:  distributed tracing (OpenTelemetry) to follow requests across services
Errors:   error tracking (Sentry) for aggregated exceptions with stack traces & context
```

Is iad na tomhais ábhartha atá le faire na **"comharthaí órga"**: fad, trácht, earráidí, agus sátúrthacht. Fógra ar siad seo a ghealadh fadhbanna roimh úsáideoirí a insint dóibh.

## Cén fáth a bhíonn tábhacht air

I táirgheachta ní féidir debugger a cheangal — **infhéachaint trí clogging agus monatóireacht an dóigh is féidir leat a thuigint, a dhíbirt, agus a oibriú** córas beo.

Gnóthaím JSON logs sruthdhronach le correlation IDs tugann siad inchoilínithe (go háirithe trasna microservices); carnáil lárnaithe déanann logs inúsáidte ar scála; agus monatóireacht le tomhais, seiceálacha sláinte, rianú dáileadh, agus fógra a bhraisteonn tú roghnú agus freagairt ar fhadhbanna go gníomhach seachas i ndiaidh úsáideoirí a bheith róghéar.

Tógáil seo isteach (ní greamú sé ina dhiaidh sin briseadh) is gníomhaireacht sainmhínithe ar fheidhmiú seirbhísí Node táirgheachta iomlán.