Skip to content

Activity and jobs

Anything that takes more than a moment is a job: installing an app, scanning a portal, taking a snapshot, deploying assets. Jobs run on a worker separate from the web server, so you can close the tab. Activity lists them all.

JobTitle on ActivityCan be cancelledEmails
Install an appInstalling app in portalNoOn failure
Scan a portalScanning portal for assetsYesNone
Take a snapshotTaking snapshot name of portalYesStart, finish, failure
Deploy assetsDeploying recipe to portal, or N assets from source to portalYesFinish, failure

Any job scheduled more than a minute ahead also emails when it starts.

Queued, Running, Succeeded, Failed, Cancelled. The sidebar’s Activity entry counts queued and running jobs; the portal’s page shows its last five.

Filter by search, portal, status, type and date range (last 7 days by default). Each row shows the job, its portal, status, when it started (or when it is scheduled), and how long it took. Watch opens a running job; Open opens a finished one.

  • Progress while running, with a label for the current step.
  • Log: every step, with Show verbose for the detail and Copy. Install jobs stream the HubSpot CLI’s output here. Failed pushes include HubSpot’s reasons and the request that was refused.
  • Results for a deploy: every item and its outcome, with links into the target portal.
  • Cancel for jobs that allow it. A queued job stops at once; a running one stops at its next checkpoint. Install jobs cannot be stopped once running.
  • Reschedule for queued jobs: pick a new time, or Keep current time.

The snapshot wizard’s Schedule for later sets a run time. The time can be changed with Reschedule while the job is still queued.

  • Each running job holds a lease and renews it regularly. If a worker dies, the lease expires and the job is handed to another worker, or failed if it has no attempts left (“The worker running this job stopped responding.”).
  • App installs get two attempts; everything else gets one.
  • When the worker restarts, cancellable jobs are paused and resume shortly after.
  • The same deploy, scan or snapshot cannot be queued twice while one is already queued or running.

The bell in the sidebar collects job starts and results, app updates (“app 1.0.4 is available for portal”) and recipes that have changed since they were deployed. Mark all read clears the badge. Read state is kept per device.

Emails come from Trading Cards and link straight to the job.