---
title: logs
description: Inspect run failures and how to resume processing.
canonical_url: https://orchestor.io/docs/en/cli/logs
markdown_url: https://orchestor.io/docs/en/cli/logs.md
contentType: reference
---

# 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`](https://orchestor.io/docs/cli/runs.md).

## Usage

```bash title="terminal"
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.

```bash title="terminal"
orc logs list <run-id> [options]
```

#### Examples

```bash title="terminal"
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.

```bash title="terminal"
orc logs follow <run-id> [options]
```

#### Examples

```bash title="terminal"
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.

```bash title="terminal"
orc logs list <run-id> --json
```

*JSON 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.

```bash title="terminal"
orc logs follow <run-id> --json
```

*Follow output*

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc logs`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)