For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro api
      • astro auth
      • astro config
      • astro context
      • astro dbt
      • astro deploy
      • astro deployment
        • astro deployment airflow upgrade
        • astro deployment create
        • astro deployment delete
        • astro deployment hibernate
        • astro deployment inspect
        • astro deployment list
        • astro deployment logs
        • astro deployment runtime migrate
        • astro deployment runtime upgrade
        • astro deployment service-account
        • astro deployment team
        • astro deployment update
        • astro deployment user
        • astro deployment wake-up
      • astro dev
      • astro ide
      • astro login
      • astro logout
      • astro organization
      • astro otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
CLI referenceastro deployment

astro deployment logs

Edit this page
Built with
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

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

OptionDescriptionPossible Values
<deployment-id>The ID of the Deployment to show logs forAny valid Deployment ID
-n, --deployment-nameThe name of the Deployment to show logs for. Use as an alternative to <deployment-id>.Any valid Deployment name
-e,--errorShow only logs with a log level of ERRORNone
-i,--infoShow only logs with a log level of INFONone
--keywordSearch the Deployment logs for a specific keyword or phrase.None
-c,--log-countThe 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.
--schedulerShow logs from the schedulerNone
--triggererShow logs from the triggererNone
-w,--warnShow only logs with a log level of WARNINGNone
--webserverShow logs from the webserverNone
--workersShow logs from the workersNone
--workspace-idSpecify a Workspace to show logs for a Deployment outside of your current WorkspaceAny valid Workspace ID

Examples

1$ astro deployment logs
2# CLI prompts you for a Deployment to view logs for
3
4$ astro deployment logs cl03oiq7d80402nwn7fsl3dmv
5# View logs for a specific Deployment
6
7$ astro deployment logs --deployment-name="My Deployment" --error --log-count=25
8# Show only the last 25 error-level logs

Related commands

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