Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Μάθετε να γράφετε γρήγορα δομημένα logs με pino: επίπεδα, redaction ευαίσθητων πεδίων και συσχέτιση με trace IDs.
Το console.log με ελεύθερο κείμενο δεν φιλτράρεται, δεν ταξινομείται και δεν συσχετίζεται. Τα δομημένα logs γράφουν μία γραμμή JSON ανά γεγονός, με σταθερά πεδία — και το pino (έκδοση 10.4.0 από το npm registry, επαληθευμένη 2026-10-26) είναι ο γρηγορότερος τρόπος να τα παράγετε στη Node 24.
Εγκατάσταση και ένας shared logger για όλη την εφαρμογή:
npm install pinoimport pino from 'pino';
export const logger = pino({
level: process.env.LOG_LEVEL ?? 'info',
});
logger.info({ route: '/api/checkout', latencyMs: 42 }, 'request completed');Κάθε γραμμή που βγαίνει στο stdout είναι αυτοτελές JSON:
{"level":30,"time":1761432000000,"pid":1234,"hostname":"vps-01","route":"/api/checkout","latencyMs":42,"msg":"request completed"}Το level: 30 είναι το info (η pino κωδικοποιεί τα επίπεδα αριθμητικά: trace 10, debug 20, info 30, warn 40, error 50, fatal 60). Σε staging βάζετε LOG_LEVEL=debug, στην παραγωγή info — τα debug logs στην παραγωγή κοστίζουν δίσκο και θόρυβο.
Κωδικοί, tokens και Authorization headers δεν πρέπει να φτάνουν ποτέ στο δίσκο. Η pino τα κόβει αυτόματα με redact:
import pino from 'pino';
export const logger = pino({
level: process.env.LOG_LEVEL ?? 'info',
redact: {
paths: ['password', 'req.headers.authorization', '*.token'],
censor: '[REDACTED]',
},
});Το πεδίο-γέφυρα ανάμεσα σε logs και traces είναι το αναγνωριστικό του request. Δέσμευσέ το μία φορά ανά request με child logger:
import { randomUUID } from 'node:crypto';
export function requestLogger(route) {
return logger.child({ reqId: randomUUID(), route });
}
const log = requestLogger('/api/checkout');
log.info({ latencyMs: 42 }, 'request completed');
log.error({ err: 'timeout' }, 'upstream failed');Με το ίδιο reqId ψάχνετε αργότερα όλες τις γραμμές ενός προβληματικού request — και το ίδιο ID μπαίνει ως trace ID όταν προσθέσετε tracing (Ενότητα 5).
const entry = { level: 30, msg: 'request completed' };
console.log(entry.level);Τι τυπώνει αυτή η γραμμή;
LOG_LEVEL=debug σε staging, info στην παραγωγή.