bkr-job-watch - Man Page

Watch the progress of a Beaker job


bkr job-watch [options] <taskspec>...


Specify one or more <taskspec> arguments to be watched. Each state change will be reported to stdout. The command will exit only when everything is finished.

The <taskspec> arguments follow the same format as in other bkr subcommands (for example, J:1234). See Specifying tasks in bkr(1).


Common bkr options are described in the Options section of bkr(1).

Exit Status

Non-zero on error, otherwise zero.


In its current implementation this command polls the Beaker server periodically for state changes. To avoid overloading the server, only the given <taskspec> arguments and none of their subcomponents are watched. This limitation will be addressed in an upcoming release (most likely by switching to a message bus).


Watch the progress of job 12345 and all recipes within it:

bkr job-watch J:12345

Due to the limitation noted above, this won't actually watch any recipes within the job, although it should.

See Also



The Beaker team <beaker-devel@lists.fedorahosted.org>

Referenced By

bkr(1), bkr-job-submit(1), bkr-update-inventory(1).

Feb 11, 2024 29.1 Beaker