Đi tới nội dung chính
System Design Lab
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ừ.

Nâng cao 4 phút đọc· Cập nhật 2026-11-18

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.

Đang tải mô phỏng…

Kho trạng thái

TrườngMục đích
workflow_id, stepWorkflow đang ở đâu.
status (pending, running, done, failed)Chuyện gì vừa xảy ra.
deadlineLúc nào supervisor nên coi bước đó là đã mất.
attemptsCò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

Tìm các bước quá hạn và cứu chúng
@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

ĐượcMất
Khả năng chịu lỗiMessage 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átKho 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ạpTá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.

Đọc thêm

Bài liên quan