Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

How to View Job Logs

Find and read the stdout/stderr output from job execution.

Find Log File Paths

torc reports results <workflow_id>
torc reports results <workflow_id> --job-id 15

Output includes:

{
  "job_id": 15,
  "job_name": "work_2",
  "status": "Failed",
  "run_id": 1,
  "return_code": 137,
  "completion_time": "2026-01-06T20:30:00.200Z",
  "exec_time_minutes": 0.09313333333333332,
  "compute_node_id": 47,
  "job_stdout": "output/job_stdio/job_wf43_j15_r1_a1.o",
  "job_stderr": "output/job_stdio/job_wf43_j15_r1_a1.e",
  "compute_node_type": "slurm"
},

Read Logs Directly

Once you have the path, view the logs:

# View stdout
cat output/job_stdio/job_wf43_j15_r1_a1.o

# View stderr
cat output/job_stdio/job_wf43_j15_r1_a1.e

# Follow logs in real-time (for running jobs)
tail -f output/job_stdio/job_wf43_j15_r1_a1.*

Default Log Location

By default, logs are stored in the output directory:

output/
└── job_stdio/
    ├── job_wf<workflow_id>_j<job_id>_r<run_id>_a<attempt_id>.o
    ├── job_wf<workflow_id>_j<job_id>_r<run_id>_a<attempt_id>.3

The output directory can be configured via the run/submit CLI options.

View Logs for Failed Jobs

Quickly find logs for failed jobs:

# Get failed job IDs
torc jobs list <workflow_id> --status failed

# Then view each job's logs
torc reports results <workflow_id> --job-id <failed_job_id>

View Logs in TUI or Dashboard

You can also view job logs interactively:

  • TUI — Run torc tui and select a job to view its stdout/stderr in the interface. See Terminal UI.
  • Dashboard — The web dashboard displays job logs when you click on a job. See Web Dashboard.

See Also