TopGit
Đánh giá repo GitHub

Winston: Node.js logging library linh hoạt

winstonjs/winston
WTopGit review image for winstonjs/winston
Review by Topgit.dev for winstonjs/winston, with GitHub repository stats and README context.
Nhận định nhanh

Winston là thư viện logging nhiều lập trình viên Node.js chọn dùng đầu tiên vì nó định tuyến log đến nhiều đích — file, console, transport khác — không cần tự viết logic đó. So với pino hướng JSON mặc định, API của Winston cũ hơn: createLogger, thêm/bớt transport bằng .add()/.remove(), pipeline format.combine() tốn code hơn. Đổi lại là quyền kiểm soát thật: lọc level theo transport, format ghép tùy ý, cấu hình khi đang chạy bằng .configure().

Sao
★ 24.5k
Fork
⑂ 1.9k
Ngôn ngữ
JavaScript
Giấy phép
MIT
Chủ đề
Developer Tools
Cập nhật
Jul 2026
Trang chủ
GitHub

Winston là gì?

Winston là một Node.js logging library dựng quanh một ý tưởng: một logger duy nhất có thể ghi ra nhiều đích cùng lúc, mỗi đích có ngưỡng severity và format riêng. Bạn tạo logger bằng winston.createLogger(), gắn các transport như Console hay File, rồi cho mỗi dòng log qua pipeline format dựng từ format.combine(). Bên trong, logger và transport hoạt động như objectMode stream, nên mỗi lần gọi log tạo ra một info object mang level và message.

Tính năng cốt lõi: transport, level và format

  • ✓Nhiều transport trên cùng một logger, mỗi transport có ngưỡng level riêng — ví dụ Console chỉ nhận log level error, còn File nhận mọi thứ từ info trở xuống.
  • ✓Config của winston.createLogger() nhận level, levels, format, transports, exitOnError và silent, mỗi tham số đều có default rõ ràng (level mặc định là 'info', format mặc định là winston.format.json).
  • ✓Level log tuân theo thứ tự severity của RFC5424; các level npm mặc định (error, warn, info, http, verbose, debug, silly) tăng dần theo số từ quan trọng nhất đến ít quan trọng nhất.
  • ✓Level và màu tùy chỉnh thông qua object levels/colors truyền vào createLogger, kết hợp với winston.addColors() để mở khóa formatter colorize().
  • ✓Pipeline format dựng bằng format.combine(), nối các formatter như timestamp(), label(), printf(), json() và prettyPrint() từ package logform riêng biệt.
  • ✓Child logger qua logger.child() gắn metadata bổ sung vào mọi message mà child logger đó phát ra, không đụng đến transport của logger cha.
  • ✓Quản lý transport khi đang chạy: logger.add(), .remove() và .clear() cho phép đổi đích log sau khi logger đã tồn tại, còn .configure() thay toàn bộ tập transport.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Thiết lập logger Winston đầu tiên

Bắt đầu bằng winston.createLogger() với một object config: đặt level (ví dụ 'info'), format (ví dụ winston.format.json()), và một mảng transports. Một pattern phổ biến là gửi log level error vào riêng một File transport ghi error.log, gửi log từ info trở lên vào một File transport khác ghi combined.log, rồi thêm Console transport có điều kiện khi process.env.NODE_ENV khác 'production' để dev vẫn có output dễ đọc. Từ đó, logger.info(), logger.warn() và các method level khác dùng được trực tiếp trên logger vừa tạo.

Khi nào nên dùng Winston

  • •Một API Express hoặc Node cần log lỗi ghi vào file bền vững, nhưng vẫn in log dễ đọc ra console khi phát triển.
  • •Một service cần định tuyến các level khác nhau đến các đích khác nhau, kiểu severity theo phong cách syslog được route theo ngưỡng level của từng transport.
  • •Một codebase muốn chuẩn hóa metadata trên mọi dòng log, dùng defaultMeta hoặc logger.child() để gắn tên service hay request ID vào từng message.
  • •Một team muốn đổi đích logging sau này mà không sửa lại toàn bộ call site — logger.info() giữ nguyên dù transport bên dưới có đổi.

Điểm mạnh

  • ✓Ngưỡng level theo từng transport nghĩa là một lần gọi createLogger() có thể âm thầm log mọi thứ vào file trong khi chỉ đưa lỗi lên console — không cần hai đường logging riêng.
  • ✓Logger và Transport về bản chất chỉ là objectMode stream, nên viết một custom transport nghĩa là hiện thực một stream interface chuẩn của Node thay vì học một plugin API riêng của Winston.
  • ✓Level và màu tùy chỉnh là tính năng chính thức: truyền object levels riêng vào createLogger() và gọi winston.addColors(), thay vì phải lách qua một danh sách severity cố định.
  • ✓Cấu hình lại một logger đang chạy không cần dựng lại từ đầu — .add(), .remove() và .configure() đổi transport ngay trên một instance đang được dùng.

Hạn chế và các gotcha thường gặp của Winston

  • △Logger mặc định từ require('winston') không có transport nào; log qua nó trước khi add một transport sẽ âm thầm không đi đâu cả, và chính README cảnh báo việc để nó không có transport có thể gây high memory usage.
  • △logger.child() được README nêu rõ là dễ lỗi khi bạn extend class Logger, vì từ khóa this không còn trỏ đúng chỗ mong đợi — một gotcha có thật, không phải giả định.
  • △Sáu tham số của createLogger() (level, levels, format, transports, exitOnError, silent), cộng với pipeline format-combine riêng, đòi hỏi học nhiều hơn so với một lệnh structured-logging duy nhất ở các thư viện mới hơn.
  • △Không có số liệu performance hay benchmark throughput nào được tài liệu hóa, nên không có cơ sở để đo Winston trước một service throughput cao nếu chưa tự test.

Lựa chọn thay thế: Winston so với pino và bunyan

pino — một Node.js logging library hướng structured JSON ngay từ đầu, với core API gọn hơn mô hình transport/format của Winston; đáng cân nhắc khi bạn muốn ít thứ phải cấu hình.log4js — một logger Node.js phỏng theo log4j của Java, có log rotation dựng sẵn và hỗ trợ nhiều appender cùng lúc; gần với cách tiếp cận đa đích của Winston hơn pino.

Câu hỏi thường gặp về Winston

Làm sao để tạo một logger với Winston?

Gọi winston.createLogger() với một object config gồm level, format và mảng transports. Ví dụ tối thiểu: level: 'info', format: winston.format.json(), transports: [new winston.transports.Console()], sau đó gọi logger.info() hoặc logger.log() để ghi một message.

Winston hỗ trợ sẵn những transport nào?

Winston có sẵn các transport lõi gồm Console và File, dựa trên networking và file I/O có sẵn của Node. Cộng đồng duy trì thêm các transport khác ngoài đó, như winston-daily-rotate-file để rotate file log theo ngày, được chính tài liệu của Winston nhắc tới trực tiếp.

Có thể dùng custom log level trong Winston không?

Winston hỗ trợ custom log level — truyền một object levels riêng vào winston.createLogger() thay vì dùng level npm mặc định (error, warn, info, http, verbose, debug, silly), rồi gọi winston.addColors() nếu muốn từng level tùy chỉnh có màu riêng.

Làm sao để thêm Winston vào một project Node.js đang có sẵn?

Cài Winston như một dependency, rồi thay các lệnh console.log rải rác bằng một logger dùng chung tạo qua winston.createLogger(), thường đặt trong module riêng để import ở bất kỳ đâu cần log. Gắn một File transport để lưu log lâu dài và một Console transport cho môi trường dev, bật tắt theo NODE_ENV.

Vì sao logger mặc định của Winston không log ra gì cả?

Logger mặc định lấy từ require('winston') không có transport nào gắn sẵn, nên gọi winston.info() trên nó sẽ âm thầm không làm gì cho đến khi bạn add một transport bằng winston.add(). Tài liệu của Winston còn cảnh báo để nó không có transport có thể dẫn tới high memory usage.

Winston có sẵn sàng cho production ở các service Node.js throughput cao không?

Thiết kế của Winston — lọc level theo từng transport, format ghép được, và cơ chế objectMode stream bên trong — nhắm đúng vào kiểu logging đa đích mà các service production cần. Tài liệu của Winston không công bố benchmark throughput nào, nên hãy tự test dưới tải thực tế, và lưu ý gotcha về logger mặc định cùng logger.child() trước khi đưa vào production ở quy mô lớn.

Vấn đề mà Winston giải quyết

console.log của Node chỉ có một đích duy nhất và không có khái niệm severity — mọi message trông như nhau và đều ra stdout. console.log không mô hình hóa severity chút nào. Ngay khi một service cần log lỗi tồn tại lâu dài trong file trong khi log info chỉ tồn tại tạm trên console, hoặc cần verbosity khác nhau theo từng environment, đó là phần logic phải tự viết trừ khi có sẵn thứ coi 'log này đi đâu' và 'log này quan trọng cỡ nào' là hai khái niệm tách biệt theo từng đích. Winston coi đích log và mức độ quan trọng là hai thứ cấu hình riêng theo từng transport, đó chính là khoảng trống nó lấp vào.

Cách cài đặt / dùng thử

README không nêu rõ lệnh npm install cụ thể, nhưng mọi ví dụ usage đều require package bằng const winston = require('winston'), điều chỉ có thể thực hiện sau khi cài package winston từ npm vào project Node.js — nên npm install winston là con đường tiêu chuẩn dù không được ghi thành dòng lệnh tường minh trong tài liệu.

Ai nên dùng — và ai nên bỏ qua

Chọn Winston nếu service Node.js của bạn đã cần nhiều hơn một đích log — file cộng console, hoặc các severity khác nhau đi các đường khác nhau — và bạn chấp nhận viết thêm chút code setup để đổi lấy quyền kiểm soát đó. Bỏ qua nếu bạn chỉ cần structured JSON ra ngay với ít cấu hình nhất: default của pino đạt được điều đó với ít thứ phải khai báo hơn. Team nào extend class Logger của Winston bằng kế thừa cũng nên dành thời gian tìm hiểu gotcha của .child() trước khi phụ thuộc vào nó.

Repo liên quan

Nguồn & ghi công

Dựa trên repository GitHub winstonjs/winston (README và metadata của repo).

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

Vẫn đang phân vân về winston?

Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về winston.

GitHub