Docs

Run and Follow a Job

Execute a run on demand, watch it, and cancel it if you need to.

You can run a job on demand with Run now on the job’s page, whether or not it also has a schedule. Manual and scheduled executions take exactly the same path through the platform, so what you see in a manual run is what the schedule will do at three in the morning.

The jaffle-core job page with a Run now button, its full and nightly schedules, a link to its runs in Monitor and its objects by namespace.
The jaffle-core job page with a Run now button, its full and nightly schedules, a link to its runs in Monitor and its objects by namespace.

Before You Trigger It  

Three things are worth confirming, because they account for most runs that fail immediately:

Follow It  

A run in the development environment appears in monitoring with its status and duration as soon as its agent starts it (runs in other environments do not appear there yet). Open it to see what it moved and which checkpoints it passed, including the error any failed step reported. When that error does not tell you enough, the agent’s own log on its host has more. See Follow a Run .

Cancel It  

A run that is doing the wrong thing can be canceled while it is still going. A run that has already finished cannot be. The control is there for stopping something in progress, not for undoing something completed.

Re-Run After a Fix  

Trigger the run again. A full load is self-correcting, so a clean execution replaces whatever the broken one left behind.

Dry-Run From the Terminal  

To check a job’s configuration without moving any data, run it from the agent host with a dry run:

amfelt sync --job <job-name> --dry-run

Run it from the directory containing amfelt.yaml, or select the project file with --path. Replace <job-name> with a job defined in that file. The dry run validates the job configuration and prints the job summary without executing data movement.

Next  

Read Metrics and Run History to see how the job behaves over time rather than once.


Last updated on October 30, 2026