Trang chủ / Kiến thức / Vận hành
Kiến thức / Vận hành

Dashboard giám sát worker: chỉ số và thiết kế

Cách thiết kế bảng điều khiển worker dựa trên trạng thái thật, log sự kiện, chỉ số vận hành, realtime và cảnh báo hữu ích.

Nguyễn Thế Lợi · Cập nhật 08/11/2026

Dashboard không chỉ để xem biểu đồ đẹp

Một hệ thống có nhiều worker cần trả lời nhanh bốn câu hỏi: công việc nào đang chạy, có đang tiến triển không, đã hoàn thành đúng chưa và ai cần can thiệp khi thất bại? Nếu dashboard chỉ lấy số lượng tác vụ từ bảng dữ liệu rồi vẽ thành biểu đồ, người vận hành vẫn phải dò log thủ công để tìm nguyên nhân lỗi.

Điều quan trọng nhất là tách dữ liệu sự thật khỏi cách trình bày. Một animation đẹp có thể hỗ trợ quan sát, nhưng không được khiến người xem tưởng tác vụ đã hoàn tất khi API thực tế chưa xác nhận.

1. Chọn nguồn dữ liệu chuẩn (source of truth)

Hãy chỉ định một nơi ghi nhận trạng thái nghiệp vụ cuối cùng, thường là cơ sở dữ liệu như PostgreSQL, MySQL hoặc SQLite tùy quy mô. Redis phù hợp để lưu cache, lease và một số loại hàng đợi; nó không tự động thay thế được cơ sở dữ liệu lưu bằng chứng nghiệp vụ. Nếu dùng cả hai, hãy định nghĩa rõ nguồn nào quyết định trạng thái hiển thị.

Ví dụ: worker cập nhật tác vụ thành SUCCEEDED trong database sau khi nhận mã kết quả hợp lệ, rồi gửi một sự kiện để dashboard làm mới. Nếu sự kiện realtime bị mất, lần truy vấn tiếp theo vẫn phải đọc được trạng thái đúng từ database.

2. Phân biệt trạng thái công việc và trạng thái hạ tầng

Đối tượngChỉ số quan trọngDiễn giải
WorkerHeartbeat, phiên bản, CPU/RAMTiến trình còn hoạt động và có tài nguyên hay không
Hàng đợiĐang chờ, tuổi tác vụ cũ nhấtCó tồn đọng hoặc quá tải không
Tác vụTrạng thái cuối, thời gian xử lý, số lượt retryCông việc thành công hay cần can thiệp
API ngoàiĐộ trễ, tỷ lệ lỗi 4xx/5xx/timeoutNguyên nhân bên ngoài hay trong hệ thống
Kết quảMã tham chiếu, thời gian xác minhCó bằng chứng tác động đã hoàn thành

Một worker còn sống không có nghĩa công việc đã tiến triển; ngược lại, worker đã thoát không nhất thiết là lỗi nếu công việc theo lô hoàn thành rồi tự dừng. Dashboard phải biểu diễn hai khái niệm này riêng.

3. Tối thiểu một dòng sự kiện cho mỗi lần chuyển bước

Mỗi khi tác vụ đổi trạng thái, ghi một sự kiện gồm: timestamp, workflow_id, job_id, from_status, to_status, step, attempt, reason_code. Đây là dữ liệu đủ để dựng timeline hoặc biểu đồ tiến trình mà không cần đọc lại log chữ tự do.

{
  "workflow_id": "daily-report",
  "job_id": "report-20261108",
  "step": "send_notification",
  "attempt": 2,
  "from_status": "RETRY_WAIT",
  "to_status": "SUCCEEDED",
  "reason_code": "DESTINATION_CONFIRMED"
}

Trên giao diện, chỉ nên hiển thị một dòng trạng thái cuối cùng ở bảng tổng quan. Người dùng có thể mở chi tiết để xem lịch sử từng lần thử; cách này vừa tránh nhiễu vừa giữ đủ dữ liệu kiểm toán.

4. Thiết kế chỉ số hữu ích thay vì đếm tất cả

Throughput là số tác vụ được hoàn tất trong một khoảng thời gian. Failure rate là tỷ lệ tác vụ thất bại theo định nghĩa nhất quán. Queue age đo thời gian chờ của công việc cũ nhất. P95 latency là ngưỡng mà 95% thời gian xử lý không vượt quá, hữu ích hơn trung bình khi có nhiều tác vụ rất chậm.

Nên phân biệt lỗi có thể retry với lỗi cần người xử lý. Việc trộn chúng vào một con số “tỷ lệ lỗi” dễ khiến dashboard tạo cảnh báo liên tục mà không hỗ trợ quyết định.

5. Cảnh báo phải có hành động đi kèm

Chỉ số và ngưỡng cảnh báo phải phù hợp khối lượng thực tế; một hệ thống chạy mỗi 2 giờ không nên bị đánh dấu chết chỉ vì 10 phút không có tác vụ.

6. Tối ưu giao diện và an toàn truy cập

Với bảng quản trị, dùng phân trang và truy vấn có giới hạn thay vì tải toàn bộ lịch sử mỗi lần mở trang. Cache có TTL ngắn cho các chỉ số tổng hợp; không cache vô hạn trạng thái đang chạy. Giao diện realtime có thể dùng Server-Sent Events hoặc WebSocket, nhưng cần cơ chế tải lại dữ liệu nếu mất kết nối.

Dashboard vận hành không nên công khai token, cookie, địa chỉ nội bộ nhạy cảm hoặc nội dung người dùng trong log. Phân quyền riêng cho thao tác xem, chạy lại và hủy công việc; hành động thay đổi trạng thái cần nhật ký kiểm toán.

7. Kiểm thử dashboard trước khi tin vào nó

  1. Tạo tác vụ thành công, thất bại có thể retry và lỗi không thể retry.
  2. Ngắt kết nối realtime, tải lại trang và kiểm tra dữ liệu hiển thị vẫn đúng.
  3. Đối chiếu số liệu dashboard với truy vấn trực tiếp trên nguồn dữ liệu chuẩn.
  4. Kiểm tra múi giờ, thời điểm cập nhật cuối, chu kỳ làm mới và phân quyền nút điều khiển.

Dashboard tốt giúp người vận hành biết cần làm gì tiếp theo, không chỉ biết có bao nhiêu ô đang nhấp nháy. Phần cơ chế job state và retry được phân tích tại bài thiết kế workflow đáng tin cậy.