> ## Documentation Index
> Fetch the complete documentation index at: https://www.ravion.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ravion logs

> Query historical CloudWatch logs and stream live log output for Ravion modules, deployments, and services straight from the command line.

## `ravion logs`

Query and stream logs

### `ravion logs cloudwatch`

Stream CloudWatch logs

```bash theme={null}
ravion logs cloudwatch [flags]
```

**Flags:**

| Flag                           | Required | Description                                             |
| ------------------------------ | -------- | ------------------------------------------------------- |
| `--aws-account-id <string>`    | yes      | Database ID of the AwsAccount to use for credentials    |
| `--log-group-name <string>`    | yes      | CloudWatch log group name                               |
| `--region <string>`            | yes      | AWS region where logs are stored                        |
| `--end-time <string>`          |          | End time for historical logs (ISO 8601)                 |
| `--filter-pattern <string>`    |          | Optional CloudWatch FilterPattern                       |
| `--json`                       |          | emit response as JSON                                   |
| `--log-stream-names <strings>` |          | Explicit list of log stream names to filter by          |
| `--log-stream-prefix <string>` |          | Log stream prefix to filter by                          |
| `--start-time <string>`        |          | Start time for historical logs (ISO 8601)               |
| `--tail`                       |          | Switch to live tail mode after fetching historical logs |

### `ravion logs pipeline-step`

Stream logs for a pipeline step execution

```bash theme={null}
ravion logs pipeline-step <step-execution-id> [flags]
```

**Flags:**

| Flag                        | Required | Description                                             |
| --------------------------- | -------- | ------------------------------------------------------- |
| `--end-time <string>`       |          | End time for historical logs (ISO 8601)                 |
| `--filter-pattern <string>` |          | Optional CloudWatch FilterPattern                       |
| `--json`                    |          | emit response as JSON                                   |
| `--start-time <string>`     |          | Start time for historical logs (ISO 8601)               |
| `--tail`                    |          | Switch to live tail mode after fetching historical logs |