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

<Info>The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.</Info>

<Tabs>
  <Tab title="Astro">
    Show [Airflow component logs](/docs/astro/view-logs#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
    ```

    <Info>When you filter logs using the command flags `--error`, `--warn`, `--info`, and `--key-word`, you can specify only one filter flag per command.</Info>

    ## 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`                                    | Any integer. If you request a number of log lines to show that exceeds the total number of logs, then it shows all existing logs. |
    | `--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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>
</Tabs>

## Related commands

* [`astro dev logs`](/docs/cli/v1.41/astro-dev-logs)
* [`astro dev run`](/docs/cli/v1.41/astro-dev-run)
* [`astro dev ps`](/docs/cli/v1.41/astro-dev-ps)