# Check and manage Task Queue

### PUQcloud Panel

##### [Order Now](https://puqcloud.com/puqcloud-panel.php) | [Download](https://github.com/puqcloud/PUQcloud) | [FAQ](https://faq.puqcloud.com/)

#### 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

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

- - - - - -

#### 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**

[![Task Queue Overview](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/1.png)](https://doc.puq.info/uploads/images/gallery/2025-10/1.png)

- - - - - -

##### 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**.

[![Date Range Filter](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/emM2.png)](https://doc.puq.info/uploads/images/gallery/2025-10/emM2.png)

- - - - - -

##### 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.

[![Task Detail View](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/3.png)](https://doc.puq.info/uploads/images/gallery/2025-10/3.png)

- - - - - -

#### Status Colors

<table id="bkmrk-color-meaning-%F0%9F%9F%A1-proc"><thead><tr><th>Color</th><th>Meaning</th></tr></thead><tbody><tr><td>🟡 **Processing**</td><td>Task is currently being executed.</td></tr><tr><td>⚫ **Queued**</td><td>Task is waiting to start.</td></tr><tr><td>🟢 **Completed**</td><td>Task has finished successfully.</td></tr><tr><td>🔴 **Failed**</td><td>Task encountered an error during execution.</td></tr></tbody></table>

- - - - - -

#### Queue Controls

<table id="bkmrk-control-description-"><thead><tr><th>Control</th><th>Description</th></tr></thead><tbody><tr><td>**Auto Refresh Interval**</td><td>Located in the top right corner. Choose how often the list updates (e.g., every 2 seconds).</td></tr><tr><td>**Switch (Off/On)**</td><td>Enables or disables automatic refreshing.</td></tr><tr><td>**Search Field**</td><td>Quickly locate jobs by name or ID.</td></tr></tbody></table>

- - - - - -

#### 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:

```json
{
  "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.