Check and manage Task Queue

PUQcloud Panel

Order Now | Download | FAQ

Overview

In PUQcloud Panel, many system operations are processed in the background, allowing multiple tasks to run simultaneously without affecting overall performance.
This background job system ensures that resource-intensive operations — such as permission checks, automated provisioning, or notifications — are executed efficiently and asynchronously.

The Task Queue section gives administrators full visibility and control over these background jobs.
It allows monitoring, filtering, and inspection of all automated system tasks.

---

Navigation Path

Dashboard → Monitoring → Task Queue

---

Key Features

Feature	Description
Background Execution	Multiple jobs run in parallel without slowing down the panel or user sessions.
Job List	Displays all queued, running, or completed background tasks.
Status Indicators	Each job shows a colored label: Pending, Processing, or Completed.
Queue Info	Indicates which queue the job belongs to (e.g., System, Default, etc.).
Dates	Displays job creation, start, and completion timestamps.
Filter Range	Allows selection of specific date/time intervals to refine results.
Task Detail View	Shows raw input and output data for each job.

---

Using the Task Queue

1. Access the Task Queue

Navigate to
Dashboard → Monitoring → Task Queue

You will see a list of recent system jobs.
Each entry contains:

• Job Name

• Queue

• Dates

• Status

---

2. Filter by Date and Time

Use the Filter field to narrow down results.
Click the date range bar and select a start and end date/time using the popup calendar.

After choosing the range, click Apply.

---

3. View Task Details

To inspect a specific job:

1. Click the eye icon next to the job.

2. A popup window will display Input Data and Output Data.

This information helps identify job parameters and verify successful completion.

---

Status Colors

Color	Meaning
🟡 Processing	Task is currently being executed.
⚫ Queued	Task is waiting to start.
🟢 Completed	Task has finished successfully.
🔴 Failed	Task encountered an error during execution.

---

Queue Controls

Control	Description
Auto Refresh Interval	Located in the top right corner. Choose how often the list updates (e.g., every 2 seconds).
Switch (Off/On)	Enables or disables automatic refreshing.
Search Field	Quickly locate jobs by name or ID.

---

Example Use Case

A system job such as
App\Jobs\CheckingAdminPermissionsJob
verifies admin permission configurations.

When completed, the Task Detail window shows output data like:

{
  "jobId": "3de9043e-dfbb-4335-9796-48e137c1b5b9"
}

---

Tips

• PUQcloud automatically manages queues, ensuring high performance even when many jobs are running simultaneously.

• Use short intervals (2–5 seconds) when debugging background tasks.

• To reduce load, disable auto-refresh when not actively monitoring.

• If a task fails, use the job ID from the output data to locate logs or related errors.