Microservice Patterns
Distributed Tracing
Theo dấu một request qua mọi service nó đi qua dưới dạng cây các span có thời gian, để thấy chính xác chặng nào làm nó chậm hay lỗi — điều mà số trung bình và log của từng service không cho thấy được.
Sau bài này bạn sẽ
- Giải thích trace, span và context propagation.
- Đọc waterfall của một trace: lồng nhau, gọi tuần tự hay song song, khoảng trống.
- Tìm phụ thuộc chậm và N+1 query từ trace.
- Gắn instrumentation bằng OpenTelemetry và chọn chiến lược sampling.
Nên đọc trước
Tổng quan
Trang tra cứu bưu kiện cho thấy mọi điểm dừng của bưu kiện và nó chờ bao lâu ở từng kho. Nếu hàng tới trễ, bạn thấy ngay nó nằm ở một kho suốt hai ngày. Trace cũng vậy với một request: mọi service nó đi qua, và mỗi nơi mất bao lâu.
Một trace là hành trình của một request. Mỗi đơn vị công việc — xử lý một HTTP request, một query database, một lời gọi sang service khác — là một span có thời điểm bắt đầu, thời lượng, trạng thái và span cha. Các service truyền trace id và id của span cha theo mỗi lời gọi (context propagation, được chuẩn hoá thành header traceparent của W3C), để backend tracing dựng lại được cái cây.
Chạy thử
Mở tab Trace trong lúc mô phỏng chạy. A là một lượt thanh toán bình thường. Ở B, p99 cao mà không có lỗi nào — chọn *Chậm nhất gần đây* để tìm thủ phạm. C ẩn giấu một N+1 query.
Đọc một waterfall
- Độ rộng là thời lượng; span lá rộng nhất thường là nguyên nhân, các span tổ tiên chỉ đang chờ.
- Bậc thang gồm nhiều span ngắn tới cùng một thành phần nghĩa là có vòng lặp gọi (N+1 query).
- Span nối đuôi nhau mà lẽ ra chạy song song được là phần độ trễ có thể tiết kiệm miễn phí.
- Khoảng trống giữa lúc span cha bắt đầu và các span con là thời gian tiêu bên trong span cha (CPU, lock, xếp hàng).
Instrumentation với OpenTelemetry
java -javaagent:opentelemetry-javaagent.jar \
-Dotel.service.name=orders \
-Dotel.exporter.otlp.endpoint=http://otel-collector:4317 \
-Dotel.traces.sampler=parentbased_traceidratio -Dotel.traces.sampler.arg=0.1 \
-jar orders.jar
# HTTP server/client, JDBC, Kafka và Redis đều thành span; traceparent được truyền tự động.Span span = tracer.spanBuilder("fraud.check").setAttribute("order.id", orderId).startSpan();
try (Scope ignored = span.makeCurrent()) {
return fraudClient.check(order);
} catch (Exception e) {
span.recordException(e);
span.setStatus(StatusCode.ERROR);
throw e;
} finally {
span.end();
}Đánh đổi
| Được | Mất | |
|---|---|---|
| Góc nhìn | Cho thấy quan hệ nhân quả xuyên service — lời gọi nào chậm, cái nào lỗi. | Chỉ đầy đủ khi context được truyền trọn vẹn: một chặng thiếu instrumentation là trace đứt. |
| Chi phí | Sampling giữ dung lượng trong tầm kiểm soát. | Lưu trữ và năng lực collector tăng theo lưu lượng và số span. |
| Công sức | Auto-instrumentation bao được các thư viện phổ biến. | Việc bất đồng bộ, queue và giao thức tự viết cần truyền context bằng tay. |
Lưu ý khi chạy production
- Truyền context qua cả header của message, để span của producer và consumer nối vào cùng một trace.
- Đặt trace id vào mọi dòng log và vào response lỗi (centralized logging).
- Liên kết trace từ dashboard độ trễ và lỗi (exemplar) để một cảnh báo dẫn thẳng tới request mẫu.
- Tránh đưa dữ liệu cá nhân vào attribute của span.