Dashboard
Total Tasks
–
Loading…
Running Now
–
workers
Failed
–
–% success rate
Queued
–
–/min throughput
Status Breakdown
Recent Tasks
| ID | Type | Status | Created |
|---|
Tasks
| ID | Type | Label / Group | Status | Priority | Created | Scheduled | Actions |
|---|---|---|---|---|---|---|---|
Create Task
Task Configuration
Settings
Connection
API Base URL
Base URL for API requests (leave blank for same origin)
API Key
Sent as Bearer token if configured on server
Connection
Test connectivity to the scheduler API
Preferences
Theme
Dark or light interface
Refresh interval
How often to poll for updates
Page size
Tasks per page in the table
Apps & API Keys
| Label | Created | Last Used | Status | Actions | |
|---|---|---|---|---|---|
Task Spec
executionMode — Task Classification
Mỗi task có một executionMode xác định scheduler xử lý kết quả như thế nào.
Default là fire-and-forget — consumer không cần làm gì thêm.
| Mode | Scheduler đánh dấu COMPLETED khi nào | Consumer cần làm gì | Ví dụ |
|---|---|---|---|
| fire-and-forget default |
HTTP 2xx (kể cả 202) | Không cần gì | TutorBot, notify, event trigger |
| async-ack | Consumer POST /v1/tasks/:id/complete |
POST callback khi xong | Payment, critical job, chain task |
async-ack — Flow chi tiết
Scheduler inject
callbackUrl + callbackToken vào request body. Consumer verify token và POST ngược lại khi hoàn thành.
1.
Scheduler gửi POST đến consumer URL kèm body trên
2.
Consumer nhận → trả 202 → task chuyển sang ◈ AWAITING_ACK
3.
Consumer xử lý xong →
POST /v1/tasks/:id/complete {"success":true}
!
Nếu
ackTimeoutMs hết mà chưa nhận callback → retry dispatch (không phải retry handler)
Dead Letter Queue
Set deadLetter.url để nhận notification khi task hết toàn bộ retry attempts.
Scheduler tạo một child task dlq.deliver để gửi — không phải fire-and-forget.
Lưu ý: DLQ notification là một task riêng với retry policy của riêng nó.
Nếu DLQ delivery cũng fail → log + alert, không đệ quy thêm.
POST /v1/tasks/:id/complete
Endpoint dành cho
async-ack consumer gọi về. Yêu cầu callbackToken (HMAC-SHA256).
| success | Kết quả |
|---|---|
true |
→ COMPLETED. result được lưu vào task. |
false |
→ RETRYING (nếu còn attempt) hoặc FAILED → DLQ |
State Machine