---
title: Worker Queue
description: The Worker Queue is where you monitor build progress and manage the resources your projects use for training models and building insights.

---

# Worker Queue {: #worker-queue }

The <em>Worker Queue</em>, displayed in the right-side panel of the application, is a place to monitor the steps of [EDA1 and EDA2](eda-explained) and set the [number of workers](#adjust-number-of-workers) used for model building:

![](images/queue-1.png)

After modeling is complete, you can [rerun Autopilot](#restart-a-model-build) at the next level ("Get More Accuracy"), [configure modeling settings](model-data#configure-modeling-settings) and rerun the project, and [unlock project holdout](unlocking-holdout).

![](images/queue-2.png)

??? tip "Minimize and expand the panel"
	 Move your mouse over the edge between the Worker Queue and the Leaderboard to expose an arrow which you can click to expand or minimize the queue:

	![](images/queue-3.png)

See the section on [troubleshooting workers](#troubleshoot-workers) for help when you cannot add workers.

## Understand workers {: #understand-workers }

DataRobot uses different types of workers for different types of jobs, such as:

* Uploading data
* Computing EDA
* Training a model
* Creating insights

The workers responsible for managing data and computing EDA are shared across an organization. They are a pool of resources to ensure that all shared services are highly available. Modeling workers, on the other hand, are allocated to each user by their administrator. The following sections describe the Worker Queue for modeling and prediction workers.

## Monitor build progress {: #monitor-build-progress }

After you start building, all running and pending models appear in the Worker Queue.

The queue prioritizes tasks based on the mechanism of the task’s submission. It starts processing “more important” jobs first, assigning all tasks submitted by Autopilot to a lower (background) priority. All other tasks (those not started by Autopilot) are assigned a default priority. For example, user-submitted tasks such as computing Feature Impact are processed by the next available worker without having to wait for Autopilot to finish building models.

You can do the following in the Worker Queue:

Display | Description
--------|-------------
[View progress](#view-progress) | See summary and detailed information about each model as it builds.
[Adjust workers](#adjust-number-of-workers) | Adjust the number of simultaneous workers used for the current build.
[Pause processing](#pause-the-worker-queue) | Pause the queue while allowing processing models to complete.
[Stop processing](#stop-the-worker-queue) | Stop the queue, removing all processing and queued models from the project.
[Reorder builds](#reorder-workers) | Reorder queued models.
[Cancel builds](#cancel-workers) | Remove scheduled builds from the queue.
[Restart model runs](#restart-a-model-build) | Select options to rerun models with different build criteria.


If a worker or build fails for any reason, DataRobot lists and records the event under **Error** at the bottom of the queue. Additionally, the event is reported in a dialog and [recorded and available](model-data#build-failure) from the Manage Projects inventory.

###  View progress {: #view-progress }

The Worker Queue is broken into two parts&mdash;models in progress and models in queue. For each in-progress model, DataRobot displays a live report of CPU and RAM use.

![](images/worker-queue-progress.png)

You can expand and collapse the list of queued models by clicking the arrow next to the queue name:

![](images/queue-collapse.png)

###  Adjust number of workers {: #adjust-number-of-workers }

You can adjust the number of workers that DataRobot uses for model building, up to the maximum number allowed for you (set by your administrator). Note that if a project was shared with you and the owner has a higher allotment, the allowed worker total displays the owners allotment, which is not necessarily what you are allowed. To increase or decrease the number of workers, click the orange arrows:

![](images/adjust-queue-workers.png)

###  Pause the Worker Queue {: #pause-the-worker-queue }

To pause the Worker Queue, click the pause symbol (double vertical bars) at the top of the queue. After pausing, the symbol changes to a play symbol (arrow).

![](images/worker-queue-pause.png)

When you pause the queue, processing continues on in-progress models. As those models complete, workers become available for the next queued model. The position is not filled until you un-pause the queue. Click the play arrow to resume building models.

###  Stop the Worker Queue {: #stop-the-worker-queue }

To stop the Worker Queue, click the "X" symbol at the top of the queue.

![](images/stop-auto-1.png)

When you stop the queue, all in-progress or queued models are immediately removed, and the modeling process ends.

### Reorder workers {: #reorder-workers }

To prioritize training specific models, you can drag-and-drop queued models to a new position.

![](images/worker-reorder-1.png)

If a job triggers dependencies, you cannot reorder the queue so that a model's dependencies are trained after the initial model. Attempting to do so returns the model to its original position in the queue. For example, launching job `A` creates two dependencies, jobs `B` and `C`. Because jobs `B` and `C` are required to build job `A`, you cannot move job `A` ahead of them in the Worker Queue. 

Note that you cannot reorder in-process models.

###  Cancel workers {: #cancel-workers }

You can remove an in-process or queued model by clicking the X next to the model name. An in-process model is immediately cancelled, a queued model is removed from the queue.

![](images/queue-kill.png)

### Restart a model build {: #restart-a-model-build }

When your build completes, or if it is paused, you can use the same data to start a new build. Restart your build from either:

* The Worker Queue, using the [**Configure modeling settings**](model-data#configure-modeling-settings) link.
* The **Data** page's [**Feature Lists**](feature-lists#rerun-autopilot) tab.

	![](images/queue-restart.png)

	Clicking the link opens a dialog box where you can select which feature list to use. Note [these considerations](feature-lists#rerun-autopilot) when selecting a list and retraining. Then, click **Restart Autopilot** to begin the new build.

	![](images/queue-select.png)

## Troubleshoot workers {: #troubleshoot-workers }

{% include 'includes/worker-queue-tbsht-include.md' %}



!!! note
    When you delete a project using the [**Actions** menu](manage-projects#project-actions-menu) in the inventory, all its worker jobs are automatically terminated.
