astro deployment logs

Show Airflow component logs for a Deployment.

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

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

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:

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

Related commands

• astro dev logs
• astro dev run
• astro dev ps