Introduction
Background jobs process large operations in the background, so you do not need to stay on the action page while the platform completes the job. While a background job is running, you can log out of the platform, close your browser or continue working.
Actions such as importing large numbers of users, importing courses or importing training materials can start a background job. Newly started background jobs usually become visible on the Background jobs page within a few seconds.
The Background jobs page provides a dashboard where you can check the status of the background jobs in your platform. The page has two tabs:
- User background jobs: This tab lists the operations that a Superadmin or Power User started.
- System background jobs: This tab lists the automated operations that the platform started on its own.
System background jobs are processes that the platform starts automatically, rather than ones that a Superadmin or Power User requests directly. The Started by value of a system background job can show the user whose action triggered it or, in some automated or scheduled cases, Staff Support. For example, the platform may start a system background job to recalculate an audience or update enrollment information.
Please note: only Superadmins and Power Users can launch background jobs or view the Background jobs page. Superadmins can view all background jobs, while Power Users have visibility only on the jobs which they themselves have launched.
Checking the background jobs page
To access the Background jobs page, from the Navigation menu > Data and analytics (chart icon) > Background jobs.
Superadmins can open the Background jobs page and view all background jobs. Power Users can open the page, but they see only the background jobs that relate to them: on the User background jobs tab, the jobs that they started, and on the System background jobs tab, the system background jobs related to them.
The following information applies to background jobs that a Superadmin or Power User started, which appear on the User background jobs tab.
The page lists all the background jobs that are currently pending or in progress, as well as the jobs that ended within the past 13 days. The status of a job can be:
- In progress: In this case a completion percentage is shown, along with the estimated time to completion (ETC). You have the option to Discontinue the job–this will interrupt the job, but any operations completed so far will not be undone. Note also that a discontinued job cannot be resumed later, or started over.
- Queued: The job is waiting its turn to be run. On some jobs you may have a Fast track option which lets you move that job to the first position in the queue.
Completed, Failed or Discontinued: These are all jobs that have ended–either successfully, with errors, or due to interruption. For these you may have the option to download the log file detailing all the operations performed by the job and any errors. You can also click the trash icon to remove a job from the list.
The Background jobs page also displays a Source column for each job.
Please note:
- The Source column may be populated with a reference to the origin of the job, depending on how the job was triggered. For example, a job triggered by an automation rule or an external integration may show the name of that source in this column.
- The availability of log files for download depends on both the type of job and how it ended. Generally, the log file is available for Failed jobs but not for Discontinued or Completed jobs, although there are exceptions
When the background job ends, you will be notified via email.
Jobs will be automatically removed from the page, and their log information deleted from the platform, after a period of 14 days. You can use the trash icon to remove a job and delete its data before that time.
Monitoring system background jobs
The System background jobs tab lists the background processes that the platform starts automatically. This tab helps you understand whether a platform operation is in progress when you are waiting for an update to complete.
To view system background jobs, open the Background jobs page and select the System background jobs tab. Select Refresh to check the latest status without leaving the page. The page shows the date and time of the last update.
Please note: System background jobs are for monitoring only. You cannot pause, stop, discontinue, fast track, restart or delete a system background job.
A system background job in progress does not necessarily indicate an error. It may simply mean that the platform is completing an automated operation.
The following table summarizes the differences between the two tabs.
| Topic | User background jobs | System background jobs |
|---|---|---|
| Started by | A Superadmin or Power User | The platform. The listed starter can be the user whose action triggered the job or, in some automated or scheduled cases, Staff Support. |
| Visible to | Superadmins see all jobs. Power Users see only the jobs that they started. | Superadmins see all jobs. Power Users see only the jobs related to them. |
| Purpose | Track the actions that you requested | Monitor automated platform activity that can affect when updates complete |
| Available actions | The actions described in this article, where supported | Monitoring only |
Examples of activities that can start system background jobs include:
- Recalculating and synchronizing audiences after relevant events, branch changes or Power User resource assignment updates.
- Recalculating the visibility of enrollment rules.
- Processing archived course enrollments and subscription bundle synchronization.
- Updating learning plan enrollment statuses and identifying certification renewal activities.
- Processing bulk enrollment archiving, anonymization or deletion.
- Synchronizing Zoom attendance information.
- Processing asynchronous updates for assets, channels and skills.
- Applying bulk updates to Power User selections.
If a system background job repeatedly fails, stays in an unexpected state or matches an incomplete update in your platform, contact Docebo Support. Include the job name, the status, the date and time and any error details or job identifier that the interface displays.
Filtering background jobs
This chapter applies to the User background jobs tab and the System background jobs tab.
To help you find jobs of interest in the list you can use the Filters panel. This allows you to search for a specific job by name, as well as to filter the list to show only those jobs that match one or more criteria. For example, jobs of a particular type (for example, unenrollment, removal), occurring within a specified time period, started by a particular user, originating from a given source (see the previous note on the Source column), or based on job status (in progress, queued, discontinued, failed, completed).