v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:15:00.000Z▲ 0 upvotes

pino жүйесіндегі Node.js жүйесіндегі құрылымдық журналдар: деңгейлер, сұрау корреляциясы және түзету

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Неліктен құрылымдық журналдар

User 42 created order 1001 in 120ms сызығы адамдар үшін ыңғайлы, бірақ журналдарды жинау жүйесі үшін пайдасыз: 42 пайдаланушының барлық тапсырыстарын табу үшін әрбір хабарлама опциясы үшін әдеттегі үлгі қажет. userId, orderId, durationMs өрістері бар JSON жазбасы мәтінді талдаусыз сүзіледі және біріктіріледі. pino дәл осындай жазбаларды жазады және оны ең аз шығынмен жасайды.

Негізгі конфигурация

// src/logger.ts
import pino from "pino";

export const logger = pino({
  level: process.env.LOG_LEVEL ?? "info",
  base: { service: "orders-api", env: process.env.NODE_ENV },
  timestamp: pino.stdTimeFunctions.isoTime,
  redact: {
    paths: [
      "req.headers.authorization",
      "req.headers.cookie",
      'res.headers["set-cookie"]',
      "*.password",
      "*.token",
      "*.cardNumber",
    ],
    censor: "[REDACTED]",
  },
});
  • base әрбір жазбаға қосылады: әртүрлі қызметтер мен орталардың service және env журналдары ортақ жадқа бөлінген.
  • isoTime дәуір миллисекундтарының орнына оқылатын уақытты береді.
  • redact көрсетілген жолдардағы мәндерді ауыстырады. Тек тізімделген жолдар үшін жұмыс істейді: *.password body.password табады, бірақ body.user.password емес. Бұл сақтандыру, тәртіпті алмастырмайды.

Журналдар stdout бағдарламасына жазылады. Жинау, айналдыру және жіберу қолданбаның емес, ортаның міндеті (Docker, systemd, платформа агенті).

Әзірлеу үшін pino-pretty тек жергілікті көлік ретінде қосылыңыз:

transport: process.env.NODE_ENV === "development" ? { target: "pino-pretty" } : undefined,

Өндірісте адам оқи алатын пішім қажет емес және талдауға кедергі келтіреді.

Жазбаларды қалай жазуға болады

logger.info({ orderId, userId, amount }, "order created");
logger.warn({ orderId, attempt }, "payment provider timeout, retrying");
logger.error({ err, orderId }, "order creation failed");

Өрістері бар нысан бірінші аргумент, қысқа тұрақты хабарлама екінші болып табылады. Айнымалылары жоқ хабарлама топтастыруға ыңғайлы: барлық «құрылған тәртіп» бір сүзгіден табылады. Қатені err өрісінде жіберіңіз: стандартты пино сериализатор type, message және stack шығарады. Басқа атпен берілген Error нысаны бос {} болады.

Деңгейлер

| Деңгей | Қашан | |---|---| | fatal | процесс жалғаса алмайды және енді | аяқталады | error | операция аяқталмады, реакция (дабыл) қажет | | warn | бірдеңе дұрыс болмады, бірақ өңделді: қайталау, деградация, сәтсіздікті шектеу | | info | маңызды іскерлік оқиғалар және өмірлік цикл: басталуы, жасалған тапсырыс, алынған төлем | | debug | жөндеуге арналған мәліметтер, өндірісте өшірілген | | trace | максималды егжей-тегжейлі, ешқашан дерлік |

Әдеттегі қате — error дұрыс емес құпия сөз немесе 404 сияқты күтілетін жағдайлар үшін. Содан кейін қателер саны туралы ескертуді боттар іске қосады және олар оған сенуді тоқтатады. Жарамсыз құпия сөз - info немесе warn, дерекқор қатесі - error.

Сұрау корреляциясы

Бір HTTP сұрауының барлық жазбаларын жинау үшін әрқайсысында оның идентификаторы болуы керек. Логерді барлық функциялар арқылы аргумент ретінде беру ыңғайсыз, сондықтан біз AsyncLocalStorage және әрбір жазбаға өрістерді қосатын mixin опциясын қолданамыз:

// src/context.ts
import { AsyncLocalStorage } from "node:async_hooks";
export const requestContext = new AsyncLocalStorage<{ requestId: string; userId?: string }>();
// src/logger.ts — дополнение к конфигурации выше
import { requestContext } from "./context";

export const logger = pino({
  // ...прежние опции
  mixin() {
    return requestContext.getStore() ?? {};
  },
});
// src/app.ts (Express)
import express from "express";
import { randomUUID } from "node:crypto";
import { requestContext } from "./context";
import { logger } from "./logger";

const app = express();

app.use((req, res, next) => {
  const incoming = req.get("x-request-id");
  const requestId = incoming && /^[\w-]{8,64}$/.test(incoming) ? incoming : randomUUID();
  res.setHeader("x-request-id", requestId);
  const started = performance.now();
  res.on("finish", () => {
    logger.info(
      { method: req.method, path: req.path, status: res.statusCode, durationMs: Math.round(performance.now() - started) },
      "request completed"
    );
  });
  requestContext.run({ requestId }, next);
});

Енді logger.info(...) сұрауды өңдеудің кез келген жерінде, соның ішінде терең кірістірілген қызметтерде requestId бар. Баланстауыштан кіріс x-request-id пішімді тексергеннен кейін қабылданады, сонда клиент журналдарға еркін мәтінді енгізе алмайды. Жауапта бірдей идентификатор берілген: пайдаланушы бұл туралы қолдау қызметіне хабарлай алады.

Express-те дайын pino-http бар және Fastify request.log және қораптан тыс сұрау идентификаторы бар кірістірілген тіркеуші ретінде pino пайдаланады.

Нені тіркеуге болмайды

  • Құпия сөздер, токендер, API кілттері, cookie файлдары, тақырыптар Authorization - кез келген нысанда.
  • Жүйеге кіру немесе құпия сөзді қалпына келтіру үшін растау кодтары мен сілтемелері.
  • Карта нөмірлері және төлем туралы ақпарат.
  • Сұраныс және жауап беру органдары. req.body емес, таңдалған өрістерді тіркеңіз: ертең олар пішінге төлқұжат деректері бар өрісті қосады және ол журналдарға үнсіз өтеді.
  • Жеке деректер қажет емес. Электрондық поштаның орнына көп жағдайда userId жеткілікті.

Журналдар көбінесе ұзақ сақталады және дерекқорға қарағанда кеңірек қол жетімді және үшінші тарап жинау қызметтерімен аяқталады.

Диагностика

  • Журналдар өндірісте пайда болмайды. Деңгей талап етілгеннен жоғары орнатылады (LOG_LEVEL=warn) немесе процесс асинхронды жазу кезінде буфер қалпына келтірілмей тұрып аяқталады. Қате қателер үшін синхронды түрде журналға кіріңіз және тіркеуден кейін процесті тоқтатыңыз.
  • Жазбаларда `requestId` жоқ. Код requestContext.run сыртында орындалады: сұраудан бұрын басталған таймерлерде немесе кезек өңдеушілерінде. Олар үшін өзіңіздің контекстіңізді жасаңыз.
  • Қате нысандары бос. Қате err өрісіне жіберілмеді.

Бұл қажетсіз болған кезде

Жүз жолдан тұратын сценарий немесе CLI утилитасы үшін console.error жеткілікті. Құрылымдық журналдар қызметтің бірнеше даналары, журналдарды жинау жүйесі және сіздің көзіңізбен емес, өрістер бойынша іздеу қажет болғанда өтеледі.

Обсуждение (0)

Ещё на vbcd4u.com