Managing Batch Jobs
The Batch Jobs page lets you monitor, inspect, and manage all batch job executions across your accessible projects.
Job List
Section titled “Job List”The Batch Jobs page shows all jobs for your accessible projects:
| Column | Description |
|---|---|
| Name | Auto-generated job identifier |
| Notebook | Path of the notebook that was executed |
| Status | Current state: pending, running, succeeded, failed |
| Project | Owning project |
| Started | Timestamp when the Kubernetes Job started |
| Completed | Timestamp when the job finished |
| Actions | View logs, view output, resubmit, delete |
Viewing Logs
Section titled “Viewing Logs”Click Logs on any job to stream output from the Papermill execution. Logs show:
- Notebook cell execution progress
- Standard output from print statements
- Error tracebacks if the notebook fails
Executing notebook with kernel: python3Executing cell 1/24Executing cell 2/24...Notebook saved to /home/jovyan/work/shared/batch_outputs/abc123/output.ipynbViewing Output
Section titled “Viewing Output”Successful jobs write the executed notebook to the shared workspace at:
/home/jovyan/work/shared/batch_outputs/<jobID>/output.ipynbYou can access it in two ways:
- In JupyterLab — open the file browser in any notebook and navigate to
shared/batch_outputs/<jobID>/ - Via Shared Files — click View Output in the job row to browse the output directory
The output notebook contains all cell outputs, including charts, tables, and print statements, captured at execution time.
Failed Jobs
Section titled “Failed Jobs”When a job fails, the error is captured and shown in the job detail view. Common causes:
| Error | Likely Cause |
|---|---|
Notebook not found | The notebook path doesn’t exist in the shared workspace |
Kernel error | Python exception in a notebook cell — check logs for traceback |
OOMKilled | Notebook exceeded memory limit — increase memory request |
DeadlineExceeded | Job ran longer than expected — optimize notebook or increase timeout |
To retry a failed job, click Resubmit.
Deleting Jobs
Section titled “Deleting Jobs”Click Delete to remove a job record. This does not delete the output notebook from the shared workspace.
Filtering by Project
Section titled “Filtering by Project”If you have access to multiple projects, use the project filter dropdown to narrow the job list to a specific project.