NAME

gerrit show-queue - Display the background work queues, including replication

SYNOPSIS

ssh -p <port> <host> gerrit show-queue

DESCRIPTION

Presents a table of the pending background activity the Gerrit daemon will perform in the near future. Gerrit contains an internal scheduler, similar to cron, that it uses to queue and dispatch both short and long term background activity.

Tasks that are completed or cancelled exit the queue very quickly once they enter this state, but it can be possible to observe tasks in these states.

ACCESS

Caller must be a member of the privileged Administrators group.

SCRIPTING

Intended for interactive use only.

DISPLAY

S

Current state of the task. States are:

  • D: task is complete, but hasn't released its worker yet.

  • C: task has been cancelled, but hasn't left the queue yet.

  • R: task is actively running on a worker thread.

  • W: task is ready to run, waiting for a worker thread.

  • S: task is sleeping until its Start time.

Start

Time (local to the server) that this task will begin execution. Blank if the task is completed, running, or ready to run but is waiting for a worker thread to become available.

Task

Short text description of the task that will be performed at the given time.

EXAMPLES

The following queue contains two tasks scheduled to replicate the tools/gerrit.git project to two different remote systems, dst1 and dst2:

$ ssh -p 29418 review.example.com gerrit show-queue
 S  Start         Task
--------------------------------------------------------------
 S  14:31:15.435  mirror dst1:/home/git/tools/gerrit.git
 S  14:31:25.434  mirror dst2:/var/cache/tools/gerrit.git
--------------------------------------------------------------
  2 tasks

DEFECTS

There is a small race condition where tasks may disappear from the output of this command while they transition from the ready/waiting (W) or sleeping (S) state to the running (R) state.


Part of Gerrit Code Review