Background jobs
Track background jobs
Some work keeps running after you start it, such as reading an uploaded document page by page, processing an import, receiving email or downloading data from a connected store. Background jobs lists that work, so you can see whether it finished and retry what failed.
Open background jobs
Open Configure, then Background jobs. The newest jobs come first, 50 per page; select Previous and Next to move between pages.
Each row shows the job’s capability, a technical name such as
documents.extract_page, then its status, how many of its items succeeded,
failed and are queued, and when it was created. The list updates every 15
seconds. Select Refresh background jobs, the refresh button at the top, to
update it now.
Document, email and store-download progress in Inbox and Sources links straight to the job behind it.
Understand a job’s status
- queued: waiting to start.
- running: in progress.
- completed: finished.
- partial_failed: some items failed. You can retry them.
- cancelled: stopped before it finished.
See a job’s details
Select a job to open its details on the right:
- When it was created, started and completed, and its Actor: user when a person started it, system when Biosphere did.
- Its items, each with its status, attempts, such as “1 of 3”, and any error.
- Job event history, the steps the job went through.
Select Refresh details to update the details, or Expand to full page to open the job on its own page.
Retry failed items
- Open a job whose status is partial_failed.
- Select the Retry failed only button.
Biosphere queues again only the failed items that have attempts left. Items that already succeeded are not repeated. A message says how many items were queued. If the same retry is sent twice, Biosphere says the earlier retry was already accepted rather than queueing the work again.