Background jobs

Where to watch background jobs

Background jobs report their progress in several places. Which one you use depends on your role and on what kind of job it is.

In the app: Settings › Organization Settings › Background Jobs tab

The Background Jobs tab

Organization admins see every job that ran for the organization on the Background Jobs tab of Organization Settings (/organization/admin?tab=jobs). This is the job list for your organization; when another page says to check your jobs, this is the place. The heading shows how many jobs are listed.

[screenshot]
The Background Jobs grid with Job ID, Job Name, State, Progress, Message, and Last Updated columns.
Column Meaning
Job ID The job’s identifier, shortened. Quote it when you ask for help.
Job Name What the job is doing, often with the object’s name, such as “Generate Description — Customer” or “Ontology Import”.
State A colored badge: blue while running (Processing), green when done (Succeeded or Completed), red for Failed.
Progress Percent complete.
Message The job’s latest status text, or the error if it failed.
Last Updated When the job last reported. The newest jobs are at the top.
  • The tab refreshes itself every 5 seconds while it’s open. Refresh reloads it immediately.
  • Filter jobs... matches the job name, message, or job id.
  • The list covers roughly the last 24 hours. Older jobs drop off; their results stay where the job put them.
  • When nothing has run recently, the tab reads “No active background jobs”.

The tab is for watching. To cancel or resume, use the job’s own screen (see below).

The Schema Imports tab

Schema imports have their own tab in Organization Settings, Schema Imports, because they have more to show: the file, the current phase, how many objects succeeded or failed, how long the import took, and controls to cancel or resume. Click a row’s open icon for the full detail page. See Watch import progress.

Home

While something is running, the Home page shows an In progress card with each running job’s name, status, and progress bar. Everyone in the organization sees it, not only admins. See Your home dashboard.

Where you started it

Many jobs show live progress on their own screen, and that’s where you act on them:

  • Ontology Generator — the run page shows the agent’s activity as it works, then the review. See Generate an ontology with AI.
  • Star Schema tab — design and build runs show progress, with a Stop button during a build. See Star schema overview.
  • Pipelines — AI rename, procedure generation, and finalize open a progress dialog.
  • SQL objects — a script’s analysis shows its progress on the object’s script tab, with a cancel button.

For site administrators

System Administration › Background Jobs (/admin?tab=jobs) is a different list: every organization’s jobs at once. Only Macula staff can open it; everyone else uses Organization Settings. See Site-wide background jobs.