- Archive
- /
- Scheduled Jobs
- /
- Monitoring Execution History
Monitoring Execution History
Learn how to view and interpret job execution history in Foreman, including status, duration, error details, and live countdowns for upcoming runs.
Every time a scheduled job runs, Foreman records an execution entry with its status, duration, and any output or error details. Use the execution history to confirm jobs are completing successfully and to troubleshoot failures.
Viewing Execution History
- Navigate to the Scheduled Jobs list.
- Click on a job name to open its detail view.
- The Recent Executions table shows a chronological list of past runs.
Each entry shows:
| Column | Description |
|---|---|
| Started At | When the execution began (displayed in your local timezone) |
| Status | Success, Failed, or Running |
| Duration | How long the execution took to complete |
| Details | Output summary or error indicator |
Click the chevron on any row to expand and view full error details, including the error message and any relevant context such as HTTP status codes or API responses.
Executions with a Running status update in real time. If a job appears stuck in this state for an unusually long time, it may have encountered an unhandled error — use Run Now to re-trigger and check for updated error details.
Live Countdown Timers
Each job displays a live countdown to its next scheduled run, colour-coded for quick scanning:
| Colour | Meaning |
|---|---|
| Amber | Less than 5 minutes until the next run |
| Blue | Less than 1 hour until the next run |
| Grey | More than 1 hour until the next run |
Hover over any countdown to see a tooltip with the full UTC datetime of the next scheduled execution.
Auto-Refresh and Live Indicator
The execution history and job list auto-refresh every 30 seconds. A green Live indicator appears at the top of the page to confirm real-time updates are active. Countdown timers tick down continuously between refreshes so you always see an accurate time remaining.
Understanding Statuses
- Success — The job completed without errors. The details column includes a summary (e.g. "Validated 142 folders, 0 discrepancies found").
- Failed — The job encountered an error and did not complete. Click the chevron to expand and see the full error message.
- Running — The job is currently in progress. Duration updates live until the job finishes.
Investigating Failures
When a job fails:
- Click the chevron on the failed execution row to expand error details.
- Review the error message for actionable information (expired tokens, network timeouts, permission issues, HTTP status codes).
- Fix the underlying cause (e.g. re-authenticate your Autodesk connection if tokens expired).
- Use the Run Now button to re-execute the job immediately and verify the fix.
Foreman automatically disables jobs that encounter non-retryable errors such as HTTP 403 (forbidden), HTTP 404 (not found), or an inactive project status. The job's status badge changes to Disabled and you will receive a failure notification email explaining why. Re-enable the job manually after resolving the underlying issue.
Auto-Disable on Non-Retryable Errors
Certain errors indicate a permanent problem that will not resolve by retrying:
| Error | Meaning |
|---|---|
| HTTP 403 | Your account no longer has permission to access the target project or resource. |
| HTTP 404 | The target project, folder, or resource has been deleted or moved. |
| Project not active | The project has been archived or deactivated in ACC. |
When Foreman detects one of these errors, it automatically disables the job to prevent repeated failures. The failure notification email includes a warning that the job has been auto-disabled.
Run Now with Delay
The Run Now button on the job detail page offers two modes:
- Run Now — triggers immediate execution.
- Run with delay — click the dropdown arrow to choose a delay (5 min, 15 min, 30 min, 1 hour, 2 hours). This sets the next execution time without changing the recurring schedule.
Manual and delayed executions appear in the history alongside scheduled runs so you have a complete audit trail.
Email Notifications
Jobs can send email notifications on completion and/or failure. When a job finishes, a notification is delivered based on your toggle settings:
- On success: email includes the job name, type, duration, and a summary of what was processed.
- On failure: email includes the job name, type, error details, and whether the job was auto-disabled.
See Job Email Notifications for full details on configuring notifications.
Snackbar Notifications
In addition to email, Foreman displays snackbar notifications (toast messages) at the bottom of the page when a job completes or fails while you are on the Scheduled Jobs page. These replace the previous inline banner approach for a cleaner, less intrusive experience.
Administrators can view execution statistics across all jobs from the Admin > Scheduled Jobs dashboard, including overall success rates, average durations, and a breakdown of failures by error type.