astro deployment logs

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
APC

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

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

Overview

Install the CLI

Develop with the CLI

Configure the CLI

Release information

Archived versions

astro deployment logs

Usage

Options

Examples

Usage

Options

Examples

​Usage

​Options

​Examples

​Usage

​Options

​Examples

​Related commands

Usage

Options

Examples

Usage

Options

Examples

Related commands