logs
orc logs inspects run execution logs in the terminal. Specify a run ID to retrieve timestamps, status, and failure reasons for each step, or display new logs continuously until completion or failure. For resumable processing, you can also inspect the next command to execute.
Use this to monitor progress or investigate failed steps. Ending log display with Ctrl+C leaves the run running. To retrieve aggregate results, use orc runs.
Usage
orc logs list <run-id>Retrieve execution logs for a run ID.
Subcommands
list
Retrieve execution logs for a run ID. Display each entry's timestamp, step, status, and failure reason. Show the next command when processing can resume.
orc logs list <run-id> [options]Examples
orc logs list <run-id>Retrieve execution logs for a run ID.
follow
Continuously display new logs for the specified run. Exit when the run completes or fails. Ctrl+C ends only the display and does not cancel the run. Running the command again resumes display from the run's current state.
orc logs follow <run-id> [options]Examples
orc logs follow <run-id>Continuously display new logs for the specified run.
Examples
JSON output
Use --json to output the result as a JSON envelope. Omit it when you need a human-readable format.
orc logs list <run-id> --jsonJSON output
Follow output
follow --json outputs each new log entry as NDJSON. If the connection drops, exit with a failure and show how to run the command again with the same run ID.
orc logs follow <run-id> --jsonFollow output
Global Options
The following global options can be used with orc logs:
For details and examples, see global options.