> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/data-pipeline-6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/data-pipeline-6/getting-started/homepage/list-jobs.md). # List Jobs All the saved Jobs by a logged-in user get listed by using this option. and The ***List Jobs*** option opens the available Jobs List for the logged-in user. All the saved Jobs by a user are listed on this page. By clicking on the Job name the ***Details*** tab on the right side of the page gets displayed with the basic details of the selected job. ## Job List * Navigate to the ***Data Pipeline*** ***Homepage***. * Click on the ***List Jobs*** option.

**Accessing the List Jobs option from Pipeline Homepage**

* The ***List Jobs*** page opens displaying the created jobs.

## Job Details & History Tabs * Select a **Job** from the displayed list, and click on it. * This will open a panel containing three tabs: ### **Job Details** The Job Details panel displays key metadata: the creator, last updater, last activation timestamp, and last deactivation timestamp. This information helps users track changes and manage their workflows effectively. * **Tasks:** Indicates the number of tasks used in the job. * **Created:** Indicates the user's name who created the job (with the date and time stamp). * **Updated:** Indicates the user's name who updated the job (with the date and time stamp). ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2FChmzBEJtsGrQNekyAeJI%2Fimage.png?alt=media\&token=82533738-4993-411d-8a5f-d6e191ed92dd) * **Last Activated:** Indicates the user's name who last activated the job (with the date and time stamp). * **Last Deactivated:** Indicates the user's name who last deactivated the job (with the date and time stamp). * **Cron Expression:** A string representing a schedule specifying when the job should run. * **Trigger Interval:** The interval at which the job is triggered (e.g., every 5 minutes). * **Next Trigger:** Date and time of the next scheduled trigger for the job. * **Description:** Description of the job provided by the user. ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2Fx7I8wuas9ABnVhPxIZNA%2Fimage.png?alt=media\&token=30c232e7-0a33-4a97-abe0-09b735e121c4) ### **Total Job Config** #### **Python Jobs** * **Total Allocated Min CPU:** Total Minimum allocated CPU (in Cores) * **Total Allocated Min Memory:** Total Minimum allocated Memory (MB) * **Total Allocated Max CPU:** Total Maximum allocated CPU (in Cores) * **Total Allocated Max Memory:** Total Maximum allocated Memory (MB) ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2FA9LJuzZ7LWRybvSEDW5P%2Fimage.png?alt=media\&token=e68bed4d-1430-4264-ac4e-02ba5221bcab) #### ***Spark*** & ***PySpark*** Jobs * **Total Allocated CPU:** Total allocated CPU cores. * **Total Allocated Memory:** Total allocated memory in megabytes (MB). ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2FNHL3wXhBFtYh8wjA76Oi%2Fimage.png?alt=media\&token=d1c0fba7-33ad-44ea-927f-6a1aae292656) ### **History** * Provides relevant information about the selected job's past runs, including success or failure status. * A ***Clear*** option is available to clear the job history. * Click on the ***Clear*** button from the History tab. * It will clear all the job run history and logs from the *History* tab and Sandbox location. * A ***Refresh*** icon is provided for refreshing the displayed job history.

* In the ***List Jobs*** page, the user can view and download the pod logs for all instances by clicking on the ***View System Logs*** option in the ***History*** tab.

**View System logs option for PySpark Job from List Jobs page**

* Once the user clicks on the View System Logs option, a drawer panel will open from the right side of the window. The user can select the instance for which the System logs have to be downloaded from the Select Hostname drop-down option.

* **Clear**: It will clear all the job run history from the ***History*** tab. * Navigate to the History section for a Job. * Click the ***Clear*** option.

* A confirmation dialog box appears. * Click the ***Yes*** option to apply the clear history. ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2Fzekuy93Cj8XoytmrPiqR%2Fimage.png?alt=media\&token=1087956b-6314-440c-98a8-baf419e5292e) * The job history gets deleted.

* You may open the ***History*** tab for the same job. It will be deleted.

## Pin & Unpin Jobs The Pin and Unpin feature allows users to prioritize and easily access specific jobs within a list. This functionality is beneficial for managing tasks, projects, or workflows efficiently. This feature is available on each job card on the ***List Jobs*** page. * Navigate to the List Jobs page. * Select the jobs that you wish to pin. * Click the ***Pin*** icon for the selected Job.

* The job gets pinned to the list for easy access and appears at the top of the job list if it is the first pinned job.

* You can use the pin icon to pin multiple jobs on the list.

* Click the ***Unpin*** icon for a pinned job.

* The selected job gets unpinned from the list.

## Job Actions A Job gets some actions to be applied under the ***Actions*** section on the ***List Jobs*** page.

Action Icon	Action Name	Description
	Push Job	Enables to Push a Job to the VCS.
	View	Redirects the user to the Job Editor page.
	Share	Allows the user to share the selected job with other user(s) or usergroup(s).
	Job Monitoring	Redirects user to the Job monitoring page.
	Edit	This enables the user to edit any information about the job. This option will be disabled when the job is active.
	Delete	Allows the user to delete the job. The deleted job will be moved to Trash.

{% hint style="info" %} *Please Note: The **Actions** section also includes the* ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2FHB0ov8BlBlLWP9fMeQKH%2Fimage.png?alt=media\&token=cbdb2027-9b2b-4cf1-a5b3-9d9448c09e07) *, and* ![](https://1987304411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwT6nkX9iZNRiZKBnpFmn%2Fuploads%2FHFzZWK5xqCQSWm10egUQ%2Fimage.png?alt=media\&token=7fb71c1d-16a8-4c79-86e0-790733f1653f) *options for a job to perform the said actions.* {% endhint %} ## Searching Job The user can search for a specific Job by using the ***Search*** ***Bar*** on the Job List.

By typing a name in the ***Search Bar*** all the existing jobs containing that word will be listed. E.g., By typing ***san*** all the existing Jobs with the word ***san*** in it get listed as displayed in the following image:

## Customizing the Job List The Job List has been provided with a header bar containing the categories of the available jobs. The user can also customize the ***Job List*** by choosing available filter options in the header.

Selecting one filter option from the Header

The Job List gets modified based on the selected category option from the header.

**Customizing the Job list based on the selected fitler option**

## Recent Run The ***Recent Runs*** status indication option provides an at-a-glance view of the five most recent job executions, allowing users to track performance in real-time. Get status display for each listed job—whether successful, failed, or in progress—is displayed, enabling users to assess system health quickly. By highlighting any issues immediately, this feature allows for proactive troubleshooting and faster response times, helping ensure seamless workflows and minimizing downtime. ### **Status Types** The Recent Run categorizes the recently run Jobs into the following statuses: 1. **Succeeded**: The job was completed successfully without any errors. 2. **Interrupted**: The job was stopped before completion, either by a user action or an external factor. 3. **Failed**: The job encountered an error that prevented it from completing successfully. 4. **Running**: The job is currently in progress. ### Status Color Coding The Job Run statuses are displayed with different color codes. * Succeeded: Green * Failed: Red * Interrupted: Yellow * Running: Blue * No Run: Grey ### Feature Details * Navigate to the ***List Jobs*** page. * The ***Recent Runs*** section will be visible for all the listed jobs indicating the statuses of the five recent most runs.

* You may hover on a status icon to get more details under the tooltip.

### Actions and Notifications Users can get a tooltip with additional details on the Job run status by hovering over the status icon in the Recent Run section. * **Status**: The status of the job run (Succeeded, Interrupted, Failed, Running). * **Started At**: The time when the job run was started. * **Stopped At**: This indicates when the job was stopped. * **Completed At**: The time when the job run was completed.

{% hint style="info" %} *Please Note:* * *The user can open the Job Editor for the selected Job from the list by clicking the **View** icon.* * *The user can view and download logs only for **successfully run** or **failed jobs**. Logs for the **interrupted jobs** cannot be viewed or downloaded.* {% endhint %}