TopGit
Đánh giá repo GitHub

Logrus: logger có cấu trúc cho Go, đang ở chế độ bảo trì

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

Logrus là một logger có cấu trúc cho Go, được xây dựng để gần như thay thế trực tiếp cho package `log` của standard library trong khi vẫn thêm fields, levels và hooks. Đây là lựa chọn ổn định, ít rủi ro cho các codebase đã dùng nó từ trước, nhưng dự án hiện ở chế độ bảo trì: chỉ vá lỗi và bảo mật, không có tính năng mới. Bắt đầu một dự án mới lại là chuyện khác, và là lý do thực sự để cân nhắc một lựa chọn đang được phát triển tích cực.

Sao
★ 25.8k
Fork
⑂ 2.3k
Ngôn ngữ
Go
Giấy phép
MIT
Chủ đề
Backend
Cập nhật
Oct 2026
Trang chủ
—
GitHub

Lý do cần structured logging trong Go

Package `log` chuẩn của Go chỉ in ra chuỗi văn bản thuần, nên debug một service bận rộn nghĩa là phải grep qua hàng loạt dòng text không có cấu trúc để tìm đúng dòng cần thiết. Logrus là một trong những thư viện Go đầu tiên gắn các fields key-value có thể truy vấn được vào mỗi dòng log thay vì vậy, nên một field như `request_id` hay `animal` có thể được lọc trực tiếp trong công cụ tổng hợp log thay vì phải tách ra từ một câu văn.

Logrus là gì

Logrus là một package Go dùng cho structured, leveled logging, gần như thay thế trực tiếp cho package `log` của standard library. Thay vì tự định dạng chuỗi lỗi bằng tay, bạn gắn các fields dạng key-value vào một lệnh log — ví dụ `logrus.WithFields(logrus.Fields{"animal": "walrus"}).Info(...)` — và Logrus sẽ render chúng dưới dạng text kiểu logfmt trên terminal, hoặc JSON khi bạn cấu hình `JSONFormatter` cho các công cụ như Splunk hay Logstash.

Tính năng chính

  • ✓Logging theo fields qua `WithFields`/`WithField`, ví dụ `logrus.WithFields(logrus.Fields{"animal": "walrus"}).Info(...)`, thay vì tự dựng chuỗi printf bằng tay
  • ✓Tương thích API với package `log` của standard library, nên chỉ cần đổi import là thường đã đủ để dùng được
  • ✓Có sẵn `TextFormatter` (tô màu khi chạy trong TTY, kiểu logfmt khi không) và `JSONFormatter` cho các công cụ tổng hợp log như Splunk hay Logstash
  • ✓Bảy log level: Trace, Debug, Info, Warning, Error, Fatal và Panic
  • ✓Hệ thống hooks để chuyển log entry tới các dịch vụ như Airbrake hay syslog, cùng thư mục `hooks/` chứa sẵn một số hooks dựng sẵn
  • ✓Có thể bọc thành một `io.Writer` qua `logger.Writer()`, cho phép chuyển hướng stdlib logger hay `ErrorLog` của `http.Server` qua Logrus
  • ✓`SetReportCaller(true)` tùy chọn thêm calling method như một field, với overhead được README ghi nhận là 20-40%
  • ✓Có sẵn `test` hook (`hooks/test`) với `test.NewNullLogger()` để assert log output trong unit test mà không cần ghi ra stdout
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 ↗

Cài đặt và import Logrus

README không nêu riêng một lệnh cài đặt. Logrus là một Go module bình thường, nên `import "github.com/sirupsen/logrus"` trong file Go là thứ kéo nó vào project, và toolchain sẽ tự resolve từ `go.mod` ở lần build tiếp theo. Một điểm cần lưu ý được README nêu rõ: tên tổ chức đã đổi thành chữ thường, nên dùng sai case trong import path sẽ gây xung đột import — `github.com/sirupsen/logrus` (chữ thường) mới là đường dẫn đúng. Cách dùng đơn giản nhất là logger ở cấp package (`logrus.WithFields(...).Info(...)`); còn nếu cần nhiều logger độc lập, `logrus.New()` tạo một instance riêng với `Out`, `Formatter` và `Level` của chính nó.

Cấu hình output, level và fields

Logrus có sẵn các giá trị mặc định hợp lý, nên phần lớn việc cấu hình chỉ là gán lại vài property trước khi bắt đầu log. `logrus.SetFormatter(&logrus.JSONFormatter{})` chuyển output sang JSON; `TextFormatter` mặc định tô màu khi có TTY và chuyển về text kiểu logfmt khi không, hoặc bạn có thể ép về plain text bằng `DisableColors: true` và `FullTimestamp: true`. `logrus.SetOutput(os.Stdout)` chuyển hướng khỏi stderr mặc định — nó nhận bất kỳ `io.Writer` nào, kể cả một file đang mở. `logrus.SetLevel(logrus.WarnLevel)` lọc bỏ mọi thứ dưới mức đó trong bảy level (từ Trace tới Panic). Để thêm ngữ cảnh cho từng lệnh, `logrus.WithFields(logrus.Fields{"animal": "walrus", "size": 10}).Info(...)` gắn dữ liệu key-value có cấu trúc vào một dòng. `logger.WithFields(...)` cũng trả về một `Entry` có thể tái sử dụng, để một request handler log `request_id` và `user_ip` trên mọi dòng mà không phải lặp lại lệnh gọi. Mỗi entry cũng tự động có ba field: `time`, `msg` và `level`.

Khi nào Logrus tỏa sáng: hooks, testing và io.Writer

  • •Chuyển lỗi tới một dịch vụ bên ngoài như Airbrake hay một syslog daemon qua `AddHook`, để các lệnh gọi `Error`/`Fatal`/`Panic` tự động phân phối đi nhiều nơi
  • •Assert log output trong unit test bằng `test.NewNullLogger()` và `hook.LastEntry()` thay vì phải capture stdout
  • •Chuyển hướng standard library logger hoặc `ErrorLog` của một `http.Server` qua Logrus bằng cách bọc nó với `logger.Writer()`
  • •Xuất log dạng JSON để nạp vào Splunk hay Logstash bằng cách chuyển sang `JSONFormatter`

Điểm mạnh

  • ✓Tương thích trực tiếp với package `log` của standard library, nên migrate một codebase sẵn có thường chỉ là đổi import
  • ✓Fields có cấu trúc (`WithFields`) giúp dòng log có thể truy vấn được trong công cụ tổng hợp, thay vì chỉ dễ đọc trên terminal
  • ✓Cả JSON formatter lẫn text formatter kiểu logfmt đều có sẵn, phủ cả nhu cầu phát triển local lẫn parse bằng máy mà không cần thêm package
  • ✓Có sẵn một `test` hook riêng giúp assert log output trong unit test đơn giản, không cần capture stdout

Giới hạn: chế độ bảo trì và hiệu năng

  • △Logrus chính thức ở chế độ bảo trì: README nói chỉ có vá bảo mật, sửa lỗi và cải thiện hiệu năng được đưa vào, không có tính năng mới nào được lên kế hoạch ngoài khả năng tương thích với `log/slog`.
  • △Không có tính năng xoay vòng log tích hợp sẵn; README nói việc này nên do một công cụ bên ngoài như `logrotate(8)` đảm nhận.
  • △`SetReportCaller(true)` thêm overhead thật sự — README ghi nhận con số 20-40% trong benchmark của chính họ — nên tính năng này tắt theo mặc định và là thứ bạn phải chủ động bật.
  • △Chính README cũng chỉ người dùng mới tới Zerolog, Zap và Apex như những lựa chọn đang được phát triển tích cực, một tín hiệu cho thấy các dự án mới đang đi về hướng nào.

Lựa chọn thay thế: Zerolog, Zap và Apex

Zerolog — logger JSON zero-allocation mà chính README của Logrus nêu ra như một lựa chọn hiện đại hơnZap — logger có cấu trúc hiệu năng cao của Uber, cũng được README của Logrus nêu tên như một lựa chọn thay thếApex — lựa chọn thứ ba mà README của Logrus nêu tên, hướng tới structured logging với nhiều backend

Có nên dùng Logrus hôm nay không?

Việc Logrus có còn hợp lý hôm nay hay không phụ thuộc vào project đang ở đâu. Một service Go đã dùng Logrus từ trước thì gần như không có lý do gì để chuyển đi: API ổn định và sẽ không thay đổi thêm nữa. Một project hoàn toàn mới lại là chuyện khác — README nêu tên Zerolog, Zap và Apex như những lựa chọn đang được phát triển tích cực mà Logrus sẽ giống nếu được thiết kế lại hôm nay, và bắt đầu một dự án mới trên một thư viện đang ở chế độ bảo trì nghĩa là chấp nhận một tập tính năng đã đóng băng ngay từ ngày đầu.

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

Logrus có còn được bảo trì tích cực không?

Logrus đang ở chế độ bảo trì: dự án chỉ nhận vá bảo mật, sửa lỗi và cải thiện hiệu năng, và README nói rõ không có tính năng mới nào được lên kế hoạch ngoài khả năng tương thích với `log/slog` của Go. Đó là toàn bộ lộ trình mà README đưa ra, nên hãy xem Logrus là ổn định chứ không còn phát triển thêm.

Logrus có tương thích với package log của standard library Go không?

Logrus được xây dựng để tương thích API với package `log` của standard library, nên bạn thường chỉ cần thay import bằng `log "github.com/sirupsen/logrus"` là các lệnh gọi log cũ vẫn chạy được. README nêu đây là một mục tiêu thiết kế cốt lõi, giúp việc áp dụng vào codebase sẵn có ít tốn công hơn.

Hiệu năng của Logrus so với Zerolog và Zap thế nào?

Logrus không công bố benchmark so sánh trực tiếp với Zerolog hay Zap trong README. Thay vào đó, README chỉ nêu tên cả hai như những lựa chọn mới hơn được thiết kế theo tư duy hiện tại về structured logging trong Go, mà không nói bên nào nhanh hơn hay đưa ra con số cụ thể nào để so sánh.

Logrus có xuất được log dạng JSON cho các công cụ tổng hợp log như Splunk hay Logstash không?

Logrus xuất được log dạng JSON cho các công cụ tổng hợp: gán `logrus.SetFormatter(&logrus.JSONFormatter{})` sẽ render mọi field dưới dạng JSON, điều mà README nói là để dễ parse bởi các công cụ như Logstash hay Splunk khi log đến nơi.

Logrus có tính năng xoay vòng log tích hợp sẵn không?

Logrus không có tính năng xoay vòng log tích hợp sẵn. README nói việc xoay vòng nên do một chương trình bên ngoài như `logrotate(8)` đảm nhận, thay vì là tính năng của logger ở tầng ứng dụng, nên bạn cần tự thiết lập việc này riêng khi triển khai.

Làm sao để viết unit test assert trên log output bằng Logrus?

Logrus có sẵn một `test` hook cho việc này: `test.NewNullLogger()` trả về một logger cùng một hook, và sau khi log bạn có thể assert trên `hook.LastEntry().Message` hay `hook.Entries` mà không cần các dòng log thực sự được in ra stdout trong lúc chạy test.

Repo liên quan

Nguồn & ghi công

Dựa trên GitHub repository sirupsen/logrus (https://github.com/sirupsen/logrus) và README 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ề logrus?

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ề logrus.

GitHub