Schedulers
The Schedulers page lets you monitor the system's background scheduled tasks — the automated jobs that run on a timer (cron schedule). You can see each job's status, recent results, and execution history, and you can enable, disable, or manually trigger a job.
⚠️ Developer Access Only
The Schedulers page lives in the Developer panel, which requires developer privileges and a one-time password (OTP) sent to the team's Telegram channel. Developer panel access lasts one hour before you need to re-authenticate.
Note: This is a monitoring tool. Schedulers are defined in the system itself — you cannot create new schedulers or edit their cron timing from this page. You can only watch them and control whether they run.
Schedulers List
Navigate to Developer → Schedulers.
The list shows every configured scheduler in a table with these columns:
| Column | Description |
|---|---|
| Name | The scheduler's name, with its task type shown underneath |
| Cron | The cron expression that controls when the job runs |
| Status | Current state — IDLE, RUNNING, or ERROR |
| Last Result | Result of the most recent run — SUCCESS, FAILED, or NONE (never run) |
| Last Run | When the job last executed |
| Duration | How long the last run took |
| Active | A check mark if the scheduler is enabled, otherwise a crossed-out circle |
You can:
- Search by Name or Task Type using the search box.
- Sort by Name or Last Run.
- Page through the list (20 per page by default).
- Click any row to open that scheduler's detail page.
Scheduler Detail
Click a scheduler in the list to open its detail page. It is organized into three areas plus an actions bar.
Actions (top of page)
| Button | What it does |
|---|---|
| Enable / Disable | Turns the scheduler on or off. The label flips depending on the current state. A disabled scheduler will not run on its schedule. |
| Run Now | Triggers the job immediately, outside its normal schedule. Disabled while the job is already RUNNING. |
Scheduler Information
| Field | Description |
|---|---|
| Name | The scheduler's name |
| Reference Key | The internal key that identifies this scheduler |
| Cron Expression | The schedule that controls when it runs |
| Task Type | The kind of task this scheduler performs |
| Description | A short description (if one is set) |
| Active | Whether the scheduler is currently enabled |
Status & Timing
| Field | Description |
|---|---|
| Current Status | IDLE, RUNNING, or ERROR |
| Last Result | SUCCESS, FAILED, or NONE |
| Last Run | When it last executed |
| Next Run | When it is scheduled to run next |
| Last Duration | How long the last run took |
| Updated | When the scheduler record was last updated |
Execution Stats (30 days)
A summary of the last 30 days of runs:
- Total Executions — number of runs in the period
- Success Rate — percentage of successful runs (shown in green at 90%+, amber at 70–89%, red below)
- Failures — number of failed runs
- Avg Duration — average run time
Execution History
Below the stats, a table lists each individual run, newest first:
| Column | Description |
|---|---|
| Status | RUNNING, SUCCESS, or FAILED |
| Started At | When the run began |
| Completed At | When the run finished |
| Duration | How long it took |
| Output / Error | The job's output, or the error message if it failed (hover to see the full text) |
Common Tasks
Viewing all schedulers
- Go to Developer → Schedulers.
- Review each job's Status, Last Result, and Last Run.
- Use the search box (by Name or Task Type) to find a specific job.
Checking why a job failed
- Open the scheduler from the list.
- Check the Execution Stats for the failure count and success rate.
- Scroll to Execution History and find a run with FAILED status.
- Read the Output / Error column (hover for the full message).
Disabling a scheduler
- Open the scheduler's detail page.
- Click Disable.
- The job stops running on its schedule until you re-enable it.
Enabling a scheduler
- Open a disabled scheduler's detail page.
- Click Enable.
- The job resumes running on its normal schedule.
Running a job immediately
- Open the scheduler's detail page.
- Click Run Now (unavailable while the job is already running).
- The job runs right away; its history and stats refresh shortly after.
Tips
- Watch the success rate — a falling success rate on the detail page is an early warning of a problem.
- Read the error output — the Execution History captures the actual error message, which is the fastest clue to what went wrong.
- Run Now doesn't change the schedule — a manual trigger runs once and does not affect the next scheduled run.
Related Pages
- Queue Process — Background jobs
- Reward Rollback Monitor — Reward rollback monitoring