> ## Documentation Index
> Fetch the complete documentation index at: https://ravion-b90c0359-devin-1788408180-cross-module-output-refs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ravion logs

> Query and stream logs for Ravion modules, deployments, and services from CloudWatch or the in-cluster Loki reached through the Operator agent.

## `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 eks-loki`

Stream in-cluster Loki logs through the Operator agent

```bash theme={null}
ravion logs eks-loki [flags]
```

**Flags:**

| Flag                                                   | Required | Description                                                                                                                                                                                               |
| ------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--deployment-resource-id <string>`                    |          | EKS workload deployment resource to tail. Mutually exclusive with --log-source-key.                                                                                                                       |
| `--end-time <string>`                                  |          | Inclusive end of the historical phase (ISO 8601). Defaults to now.                                                                                                                                        |
| `--json`                                               |          | emit response as JSON                                                                                                                                                                                     |
| `--log-source-key <<moduleInstanceId>::<logSourceId>>` |          | Composite \<moduleInstanceId>::\<logSourceId> key of the ui.logs source to tail. Mutually exclusive with --deployment-resource-id.                                                                        |
| `--search <string>`                                    |          | Case-sensitive substring the line must contain, compiled to a LogQL line filter. A plain string rather than the structured filter tree because a recursive model cannot ride a query param on an SSE GET. |
| `--start-time <string>`                                |          | Inclusive start of the historical phase (ISO 8601). Defaults to fifteen minutes before now.                                                                                                               |
| `--tail`                                               |          | Continue into a live tail after the historical phase.                                                                                                                                                     |

### `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 |