Đi tới nội dung chính
System Design Lab
Microservice Patterns

Centralized Logging

Đưa log của mọi service về một nơi tìm kiếm được, dưới dạng event có cấu trúc mang correlation id, để lần theo được một request lỗi qua mọi service và instance nó đã chạm tới.

Cơ bản 5 phút đọc· Cập nhật 2026-11-18

Sau bài này bạn sẽ

  • Giải thích vì sao file log trên từng máy không còn dùng được trong hệ thống phân tán.
  • Viết log có cấu trúc kèm correlation id (trace id).
  • Lần theo một request lỗi qua nhiều service và instance.
  • Kiểm soát dung lượng, chi phí và dữ liệu nhạy cảm trong log.

Tổng quan

Nếu mỗi cửa hàng trong chuỗi giữ một cuốn sổ hoá đơn giấy riêng, muốn biết chuyện gì đã xảy ra với đơn của một khách thì phải đi khắp các cửa hàng. Gom mọi hoá đơn vào một hệ thống tìm kiếm được, hoá đơn nào cũng ghi mã đơn, thì chỉ cần gõ mã một lần.

Trong hệ thống phân tán, một thao tác của người dùng sinh ra log trên nhiều service và instance, mà chúng có thể bị khởi động lại hay thay thế bất cứ lúc nào. Centralized logging đưa mọi dòng log về một kho duy nhất (Elasticsearch/OpenSearch, Loki, một dịch vụ cloud). Hai thói quen làm nó hữu ích: log có cấu trúc (trường JSON, không phải văn bản tự do) và correlation id — tốt nhất là trace id — trên mọi dòng.

Chạy thử

Mở tab Trace và mở rộng mục *Dòng log mang trace id này*. Ở A, tìm xem service nào đứng sau những lỗi chung chung của gateway. Ở B, ba instance orders trông giống hệt nhau trên số liệu tổng — dòng log của những request lỗi sẽ phân biệt được chúng.

Đang tải mô phỏng…

Những trường mọi dòng log nên có

TrườngVì sao
timestamp (UTC, ms)Sắp thứ tự event giữa các máy.
service, instance, versionBản deploy nào đã ghi — instance hay bản release lỗi (kịch bản B).
trace_id, span_idNối mọi dòng của một request; nhảy sang trace của nó.
level, message, eventMức độ nghiêm trọng và tên event ổn định, tìm kiếm được.
Id nghiệp vụ (order_id)Trả lời câu hỏi của bộ phận hỗ trợ — không bao giờ là secret hay dữ liệu cá nhân đầy đủ.

Log có cấu trúc kèm trace id

Spring Boot: log JSON; Micrometer Tracing đặt traceId/spanId vào MDC
logging.structured.format.console=ecs
logging.structured.ecs.service.name=orders
logging.structured.ecs.service.version=${APP_VERSION}
management.tracing.sampling.probability=0.1
# Mọi dòng log giờ đều mang trace.id và span.id — tìm kiếm: trace.id:"4bf92f3577b34da6"
Log event, đừng log văn xuôi
log.atWarn()
   .setMessage("payment declined")
   .addKeyValue("event", "payment.declined")
   .addKeyValue("order_id", order.id())
   .addKeyValue("provider_code", response.code())
   .log();
// Trả trace id cho client trong response lỗi để bộ phận hỗ trợ tìm được log.
  • Audit log: ghi lại ai đã làm gì với đối tượng nghiệp vụ nào và lúc nào (hoàn tiền, đổi quyền, xuất dữ liệu) trong một kho chỉ ghi thêm, lưu lâu hơn — tách khỏi log debug, và truy vấn được cho mục đích tuân thủ.
  • Theo dõi exception: gửi exception không được xử lý tới một công cụ theo dõi (Sentry, Rollbar, App Insights) biết gộp lỗi trùng, đếm số người dùng bị ảnh hưởng và cảnh báo khi xuất hiện loại lỗi mới — tìm chi tiết trong log, xem xu hướng trong công cụ theo dõi.
  • Ghi log deploy và thay đổi: phát một event cho mỗi lần deploy, đổi cấu hình và bật/tắt feature flag, và hiển thị chúng thành mốc trên dashboard; phần lớn sự cố bắt đầu ngay sau một thay đổi.

Đánh đổi

ĐượcMất
DebugMột lần tìm là thấy trọn câu chuyện của request qua mọi service.Chỉ khi mọi service ghi correlation id một cách nhất quán.
Chi phíLưu trữ phân tầng giữ log cũ ở mức rẻ.Chi phí nạp và đánh index tăng theo dung lượng; log dài dòng rất đắt.
Tín hiệuChi tiết phong phú cho từng event.Kém khi xem xu hướng — dùng metrics cho tốc độ và percentile.

Lưu ý khi chạy production

  • Ghi log ra stdout và để nền tảng chuyển đi; đừng bao giờ phụ thuộc vào file nằm trên instance.
  • Thống nhất tên trường giữa các service (cấu hình logging dùng chung hoặc quy ước ECS / OpenTelemetry).
  • Lấy mẫu hoặc giới hạn tốc độ log ồn ào thay vì tắt hẳn.
  • Cảnh báo bằng metrics, điều tra bằng log và trace.

Đọc thêm

Bài liên quan