# Job monitoring

> Job Monitoring Dashboard records in realtime every job executed against your resources, timestamp of dates and times, status and the user who triggered the jobs.

:::tip Knowledge Checkpoint
A grasp of these concepts will help you understand this documentation better:
- [Job Queues and Workers](/docs/jobs/queues-and-workers)
:::

## Required permissions
:::info Notes
This page is accessible by **Admins** and **Analysts** only.  
Learn more about user roles [here](/docs/admin/user-roles).
:::

* **Admins** can monitor **all jobs** within the Holistics workspace.
* **Analysts** can monitor jobs on **permitted Data Sources**.
    * To permit Analysts to monitor jobs on a specific Data Source:
        1. Go to [Data Source management page](/docs/data-source-management)
        2. Click **Share**
        3. Add permission with Action **Monitor Jobs** for your Analysts
            
    * Analysts **cannot** monitor [Job Queues & Workers](#monitoring-job-queues--workers).
    * Analysts **cannot** view [Job Performance Analytics](#job-performance-analytics).

## How to access
To access Job Monitoring, go to 
menu  Menu -> monitor Jobs Monitoring.

Or you can use the direct link corresponding to your workspace's domain. Here are the links for the common domains:
* APAC: https://secure.holistics.io/manage/jobs
* US: https://us.holistics.io/manage/jobs
* EU: https://eu.holistics.io/manage/jobs

## Monitoring jobs
The **Jobs** tab displays in realtime every job executed in your Holistics workspace.
It includes helpful details such as:
- **Source** of the job
- **Timestamps** (creation, start, end)
- **Durations**
  - Pending duration: How long the job waited in the queue
  - Running duration: How long the job ran
- **Status** of the job
- **User** who triggered the job.

There is also a built-in filter to help you query the records you need.

### Filtering
The built-in filter allows you to narrow down jobs that fit your pre-defined set of criteria in the Job Monitoring Dashboard.

<details>
  <summary>
    Job Status Filter
  </summary>

This filter will help you to find jobs by their statuses. To learn more about all job status available in Holistics, please refer to [Job Queue Management](/docs/jobs/queues-and-workers#life-cycle-of-a-job).

We also offer **two additional filters** for common job status:
- **All unfinished statuses**: which include **Starting**, **Pending**, **Running**.
- **All finished statuses**: which include **Success**, **Failure**, **Already Existed**, **Cancelling**, **Cancelled**.

</details>

<details>
  <summary>
    Source Type Filter
  </summary>

This filter is useful to discover all jobs that have been fired by a particular type of resources.

</details>

## Monitoring job queues & workers
:::info Required Permissions
Available to **Admins** only.
:::

In the **Job Queues & Workers** tab, you will find a listing of your Job Workers, including:
* **Percentage**: Percentage of Job Workers that are busy
  * I.e. The percentage of Busy Workers over Total Workers.
* **Busy Workers**: Number of Job Workers that are actively executing Jobs.
* **Total Workers**: Total number of Job Workers that are available in a certain Job Queue.

## Job performance analytics
:::info Available in Open Beta
Please check out our [announcement](https://community.holistics.io/t/closed-beta-job-performance-analytics-dashboard/1793).
:::

:::info Required Permissions
Currently available to **Admins** only.
:::

## Data retention period
Please refer to our [Data Retention Policy](/docs/security-compliance/data-retention) for more information.