---
title: "alis logs"
url: "https://docs.alisx.com/reference/cli/logs/"
---
# alis logs

Read build, deployment and Cloud Run runtime logs.

## Synopsis

```bash
alis logs build <operation> [flags]
alis logs deploy <operation> [flags]
alis logs runtime [package] [flags]
```

## Description

`build` and `deploy` read the bounded execution log of an operation by its name (`operations/<id>`), as printed by `alis build`, `alis deploy` or `alis operations list`. `runtime` reads recent Cloud Run logs for a service in one deployment environment.

## Subcommands

### alis logs build

Read build execution logs.

```bash
alis logs build <operation> [flags]
```

| Flag | Type | Default | Meaning |
|---|---|---|---|
| `--limit <n>` | int | `200` | Maximum lines per log group (also capped at 128 KiB). |
| `--package <id>` | string | | Package ID when the operation is not recorded locally. |

### alis logs deploy

Read deploy execution logs.

```bash
alis logs deploy <operation> [flags]
```

| Flag | Type | Default | Meaning |
|---|---|---|---|
| `--limit <n>` | int | `200` | Maximum lines per log group (also capped at 128 KiB). |
| `--package <id>` | string | | Package ID when the operation is not recorded locally. |

### alis logs runtime

Read recent Cloud Run logs in the deployment environment's configured region. The package may be omitted inside the service's directory.

```bash
alis logs runtime [package] [flags]
```

| Flag | Type | Default | Meaning |
|---|---|---|---|
| `-e`, `--environment <id>` | string | | Target deployment environment id or name (required). |
| `--limit <n>` | int | `100` | Maximum entries, newest first (1 to 1000). |
| `--since <duration>` | duration | `30m` | Look back this duration, at most `168h`. |

## Examples

```bash title="Terminal"
alis logs build operations/<id> --json
alis logs deploy operations/<id> --limit 500 --json
alis logs runtime acme.shop.orders.v1 -e <env-id> --since 2h --limit 200 --json
```

## JSON output

Readable, bounded log tails. Use these for diagnosis after a failed operation together with the operation's `logsUri`.