queue status

Show status of tasks and workers for the DVC experiment task queue.

Synopsis

dvc queue status

Description

Shows the status of queued and running experiments in the queue, as well as the status of running workers (see dvc queue start).

$ dvc queue status
Task     Name    Created    Status
753b005          04:01 PM   Running
1ae8b65          04:01 PM   Queued

Worker status: 1 active, 0 idle

Options

-h, --help - prints the usage/help message, and exit.
-q, --quiet - do not write anything to standard output.
-v, --verbose - displays detailed tracing information.

Examples

Before adding any experiments to the task queue and before starting the queue worker process, we can verify the queue status:

$ dvc queue status
No experiment tasks in the queue.

Worker status: 0 active, 0 idle

Let's add some experiments to the queue:

$ dvc exp run --queue -S prepare.split=0.25 -S featurize.max_features=2000
Queued experiment '0bbb118' for future execution.
$ dvc exp run --queue -S prepare.split=0.30 -S featurize.max_features=2500
Queued experiment '753b005' for future execution.
$ dvc exp run --queue -S prepare.split=0.35 -S featurize.max_features=3000
Queued experiment '1ae8b65' for future execution.

And verify the queue status:

$ dvc queue status
Task     Name    Created    Status
753b005          04:01 PM   Queued
0bbb118          04:01 PM   Queued
1ae8b65          04:01 PM   Queued

Worker status: 0 active, 0 idle

Let's start 2 queue workers, so up to 2 experiments will be run at a time in parallel:

$ dvc queue start -j 2
Started '2' new experiments task queue workers.
$ dvc queue status
Task     Name    Created    Status
753b005          04:01 PM   Running
0bbb118          04:01 PM   Running
1ae8b65          04:01 PM   Queued

Worker status: 2 active, 0 idle

Once the first two experiments have completed and the third is running, we can see that the second worker process becomes idle:

$ dvc queue status
Task     Name    Created    Status
1ae8b65          04:01 PM   Running
753b005          04:01 PM   Success
0bbb118          04:01 PM   Success

Worker status: 1 active, 1 idle

And once all tasks in the queue have been processed, the workers shut down:

$ dvc queue status
Task     Name    Created    Status
753b005          04:01 PM   Success
0bbb118          04:01 PM   Success
1ae8b65          04:01 PM   Success

Worker status: 0 active, 0 idle