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.
- Astro
- Software
Show Airflow component logs 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
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.
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
$ 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
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 Software UI.
Usage
Run one of the following commands depending on which logs you want to stream:
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
# 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