bkr job-watch: 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