What is the Task Queue Monitor?
The Task Queue Monitor in WHM displays information about cPanel & WHM's internal task queue in real time. When a task runs or is queued to run, this interface shows the task name, its status, and relevant details. This is useful for monitoring server processes such as Apache rebuilds, backup operations, and scheduled maintenance tasks.
Steps to Check Queued Tasks
- Log in to WHM as the root user.
- Navigate to Home » Server Status » Task Queue Monitor.
- The interface displays all queued and active tasks in real time. Check the status column for each task to understand its current state.
Understanding Task Statuses
- Processing — The task is currently running.
- Pending — The task will run after the current processing queue finishes.
- Scheduled — The task will run at a specific time determined by the associated module.
- Deferred — The task will run at a time specified by the module.
Viewing Task Details
Select the Show Task Details checkbox at the top of the interface to display additional information for each task, including:
- Command — The specific command the task executes (e.g.,
_build_apache_conf). - Enqueue Time — The time the task entered the queue.
- Process ID — The process number of the in-progress task.
- Remaining Retries — How many more times the system will retry the task if it fails.
- Child Timeout — The maximum time (in seconds) allowed for the task before it times out.
- Task ID — The unique identification number for the task (e.g.,
TQ:TaskQueue:1657).
Important Notes
- The Task Queue Monitor updates in real time — you do not need to refresh the page manually to see new tasks.
- The Process ID displayed belongs to the process performing the task, not the task itself, since a single process can handle multiple tasks.
- If a task fails and has remaining retries, it will automatically re-enter the queue.
Troubleshooting
- No tasks are showing: This is normal if no operations are currently queued. Tasks appear when cPanel & WHM performs actions such as rebuilding Apache configuration, processing backups, or running scheduled maintenance.
- A task appears stuck in Processing: Check the Process ID in task details and use the command line to investigate the process. You may need to restart the affected service if a task has timed out.
- Access denied: Ensure you are logged in as root. The Task Queue Monitor is not available to reseller-level accounts.
For official documentation, see the cPanel Task Queue Monitor guide.
