Khi một request đi qua nhiều Microservices khác nhau nhưng lại gặp lỗi ở service cuối cùng, làm thế nào để dev có thể trace lại toàn bộ hành trình của request đó để tìm nguyên nhân?

Question

Accepted Answer

Bản chất vấn đề
Trong kiến trúc Microservices, một request từ client có thể kích hoạt chuỗi gọi qua 5-10 service khác nhau (ví dụ: API Gateway -> Order Service -> Inventory Service -> Payment Service -> Notification Service). Khi xảy ra lỗi, việc tra cứu log riêng lẻ của từng service là cực kỳ khó khăn vì các log này nằm rời rạc ở nhiều server khác nhau và không liên kết được với nhau theo ngữ cảnh của request ban đầu.
Giải pháp: Distributed Tracing & Correlation ID
Để giải quyết bài toán này, hệ thống áp dụng kỹ thuật Distributed Tracing dựa trên hai khái niệm chính:

Correlation ID (Request ID):

Khi request vừa chạm đến API Gateway, hệ thống sẽ sinh ra một mã định danh duy nhất (thường là UUID) gọi là Correlation ID.
Mã này được gắn vào HTTP Header (ví dụ: X-Correlation-ID) và được truyền xuyên suốt qua tất cả các lời gọi HTTP hoặc Message Broker tới các microservice tiếp theo.
Khi ghi log, mọi service đều phải in kèm Correlation ID này.

Distributed Tracing Tools:

Sử dụng các công cụ chuyên dụng như Jaeger, Zipkin hoặc OpenTelemetry để tự động thu thập, trực quan hóa toàn bộ sơ đồ gọi (Call Graph) cùng thời gian thực thi của từng service.

Ví dụ thực tế
Đoạn code cấu hình tự động truyền Correlation ID qua RestTemplate trong Spring Boot:
@Bean
public RestTemplate restTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.setInterceptors(Collections.singletonList((request, body, execution) -> {
        String correlationId = MDC.get("correlationId");
        if (correlationId != null) {
            request.getHeaders().add("X-Correlation-ID", correlationId);
        }
        return execution.execute(request, body);
    }));
    return restTemplate;
}
Lưu ý kinh nghiệm cho Junior

Luôn trích xuất X-Correlation-ID từ HTTP Header vào thư viện Logging Context (như MDC trong SLF4J) ngay khi request vừa vào service.
Khi đẩy log lên hệ thống tập trung (như ELK Stack - Elasticsearch, Logstash, Kibana), trường correlationId phải được đánh index (filterable) để có thể dễ dàng search toàn bộ vết lỗi của một request cụ thể.

Khi một request đi qua nhiều Microservices khác nhau nhưng lại gặp lỗi ở service cuối cùng, làm thế nào để dev có thể trace lại toàn bộ hành trình của request đó để tìm nguyên nhân?

Bản chất vấn đề

Làm Chủ Phỏng Vấn & Nâng Cao Trình Độ Chuyên Nghiệp

Tải Tuyển Tập 100+ Câu Hỏi Phỏng Vấn Chuyên Sâu (PDF)

Cần Mentor Phỏng Vấn Thử 1-1 & Tối Ưu CV?

Kiểm Tra CV Chuẩn ATS Miễn Phí

Câu hỏi microservices liên quan cùng chủ đề