Microservice Patterns
Scheduler Agent Supervisor
Chạy một workflow phân tán nhiều bước với ba vai trò: scheduler điều khiển các bước, agent làm việc từ xa, và supervisor tìm những bước bị kẹt hay lỗi để retry hoặc bù trừ.
Sau bài này bạn sẽ
- Mô tả ba vai trò và kho trạng thái bền vững chúng dùng chung.
- Thấy vì sao câu trả lời bị mất làm workflow kẹt mãi khi không có giám sát.
- Cứu các bước bị kẹt bằng deadline, retry và bù trừ.
- Liên hệ pattern này với saga và workflow engine.
Nên đọc trước
Tổng quan
Người lên kế hoạch đám cưới (scheduler) đặt địa điểm, bên tiệc và ban nhạc (agent). Một người giỏi còn giữ danh sách kiểm tra và gọi lại bất kỳ ai chưa xác nhận khi tới hạn (supervisor) — nếu không, chỉ một email thất lạc là ngày cưới không có ban nhạc.
Scheduler khởi động từng bước của workflow và ghi tiến độ vào một kho trạng thái bền vững. Agent bọc phần việc từ xa (nhà cung cấp thanh toán, API đặt chỗ) và báo lại kết quả. Vì message có thể mất và agent có thể crash, một supervisor riêng định kỳ quét kho trạng thái tìm những bước đã quá hạn hoặc bị lỗi, rồi retry chúng (agent phải idempotent) hoặc kích hoạt bước bù trừ.
Chạy thử
Mỗi lượt đặt chỗ chạy ba bước. Từ t = 8 s tới 14 s mạng tới charge-card âm thầm làm rơi message. Xem ô Lượt đặt chỗ đang xử lý sau khi mạng hồi phục, khi có và không có supervisor.
Kho trạng thái
| Trường | Mục đích |
|---|---|
workflow_id, step | Workflow đang ở đâu. |
status (pending, running, done, failed) | Chuyện gì vừa xảy ra. |
deadline | Lúc nào supervisor nên coi bước đó là đã mất. |
attempts | Còn bao nhiêu lần retry trước khi bù trừ. |
lock_owner, version | Để chỉ một scheduler/supervisor xử lý một workflow tại một thời điểm. |
Phác thảo supervisor
@Scheduled(fixedDelay = 1000)
@SchedulerLock(name = "booking-supervisor") // mỗi lúc chỉ một supervisor
void supervise() {
for (WorkflowStep step : steps.findRunningPastDeadline(Instant.now(), 100)) {
if (step.attempts() < MAX_ATTEMPTS) {
steps.markRetrying(step.id(), step.version(), Instant.now().plus(STEP_TIMEOUT));
agents.resend(step); // agent idempotent: lặp lại an toàn
} else {
steps.markFailed(step.id(), step.version());
compensations.start(step.workflowId()); // hoàn tác các bước đã xong, như saga
}
}
}Đánh đổi
| Được | Mất | |
|---|---|---|
| Khả năng chịu lỗi | Message mất và agent crash không còn làm việc bị kẹt. | Retry đòi hỏi agent idempotent; việc cứu diễn ra theo chu kỳ quét. |
| Quan sát | Kho trạng thái cho thấy tiến độ của mọi workflow. | Kho và supervisor là thành phần sống còn phải vận hành và scale. |
| Độ phức tạp | Tách bạch rõ việc điều khiển, thực hiện và kiểm tra. | Nhiều thành phần hơn một chuỗi gọi đồng bộ đơn giản. |
Lưu ý khi chạy production
- Đặt deadline cho từng bước theo độ trễ thực tế của agent, không dùng một giá trị chung.
- Cảnh báo khi workflow kẹt lâu hơn dự kiến và theo tỉ lệ phải bù trừ.
- Làm cho chính supervisor có availability cao (dùng lease, xem leader election).
- Ghi lại mọi lần thử — khi workflow trục trặc, lịch sử đó là thứ bộ phận hỗ trợ cần.