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

# astro deployment logs

> Show Airflow component logs for a Deployment.

> [!NOTE]
>
> The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.

**Astro**

Show [Airflow component logs](https://astronomer.io/docs/astro/view-logs.md#view-airflow-component-logs-in-the-astro-ui) over the last 24 hours for a given Deployment on Astro. These are the same logs that appear in the **Logs** tab of the Astro UI.

## Usage

```sh wrap theme={null}
astro deployment logs
```

> [!NOTE]
>
> When you filter logs using the command flags `--error`, `--warn`, `--info`, and `--key-word`, you can specify only one filter flag per command.

## Options

| Option | Description | Possible Values |
| - | - | - |
| `<deployment-id>` | The ID of the Deployment to show logs for | Any valid Deployment ID |
| `-n`, `--deployment-name` | The name of the Deployment to show logs for. Use as an alternative to `<deployment-id>`. | Any valid Deployment name |
| `-e`,`--error` | Show only logs with a log level of `ERROR` | None |
| `-i`,`--info` | Show only logs with a log level of `INFO` | None |
| `--keyword` | Search the Deployment logs for a specific keyword or phrase. | None |
| `-c`,`--log-count` | The number of log lines to show. The default is `500`. The Astro CLI paginates the underlying API to return the full requested number of lines. | Any integer. If you request a number of log lines that exceeds the total number of logs, then it shows all existing logs. |
| `--component` | Show logs from one or more components by name, passed as a repeatable flag or a comma-separated list. Use as an alternative to flags such as `--scheduler` or `--triggerer`. | Any valid component name, for example `scheduler` or `dag-processor` |
| `--dag-processor` | Show logs from the Dag processor | None |
| `--scheduler` | Show logs from the scheduler | None |
| `--triggerer` | Show logs from the triggerer | None |
| `-w`,`--warn` | Show only logs with a log level of `WARNING` | None |
| `--webserver` | Show logs from the webserver | None |
| `--workers` | Show logs from the workers | None |
| `--workspace-id` | Specify a Workspace to show logs for a Deployment outside of your current Workspace | Any valid Workspace ID |

## Examples

```sh wrap theme={null}
$ astro deployment logs
# CLI prompts you for a Deployment to view logs for

$ astro deployment logs cl03oiq7d80402nwn7fsl3dmv
# View logs for a specific Deployment

$ astro deployment logs --deployment-name="My Deployment" --error --log-count=25
# Show only the last 25 error-level logs

$ astro deployment logs cl03oiq7d80402nwn7fsl3dmv --dag-processor
# Show Dag processor logs for a specific Deployment

$ astro deployment logs cl03oiq7d80402nwn7fsl3dmv --component scheduler,dag-processor
# Show logs from multiple components in a single command
```

**APC**

Show Airflow component logs over the last 24 hours for a given Deployment. These logs are the same logs that appear in the **Logs** tab of the UI.

## Usage

Run one of the following commands depending on which logs you want to stream:

```sh wrap theme={null}
astro deployment logs <deployment-id> scheduler
astro deployment logs <deployment-id> webserver
astro deployment logs <deployment-id> workers
astro deployment logs <deployment-id> triggerer
```

## Options

| Option | Description | Possible values |
| - | - | - |
| `<deployment-id>` (\_Required) | The ID of the Deployment for which you want to view logs | Any valid Deployment ID |
| `<airflow-component>` (\_Required) | The Airflow component for which you want to view logs | `scheduler`, `webserver`, `workers`, or `triggerer` |
| `--follow` | Subscribes to watch more logs | None |
| `--search` | Searches for the specified string within the logs you're following | Any string |
| `--since` | Limits past logs to those generated in the lookback window | Lookback time in `h` or `m` (for example, `5m` or `2h`) |

## Examples

```sh wrap theme={null}
# Return logs for last five minutes of webserver logs.
$ astro deployment logs webserver example-deployment-uuid

# Return logs from airflow workers for the last 5 minutes with a given search term, and subscribe to view more as they are generated.
$ astro deployment logs workers example-deployment-uuid --follow --search "some search terms"

# Return logs from airflow webserver for last 25 minutes.
$ astro deployment logs webserver example-deployment-uuid --since 25m
```

## Related commands

* [`astro dev logs`](https://astronomer.io/docs/cli/v1.47/astro-dev-logs)
* [`astro dev run`](https://astronomer.io/docs/cli/v1.47/astro-dev-run)
* [`astro dev ps`](https://astronomer.io/docs/cli/v1.47/astro-dev-ps)