troubleshooting-astro-deployments

What problem does it solve?

This Skill helps you pinpoint why an Astronomer (Astro CLI) production deployment is failing, unhealthy, slow, or misconfigured by guiding you through targeted log review and environment variable inspection.

Core Features & Use Cases

• Deployment discovery and health assessment: Use deployment listing and inspection to identify the target deployment and confirm statuses, runtime compatibility, and resource constraints.
• Targeted, component-specific log investigation: Review scheduler, workers, webserver, and triggerer logs with focused filters for error levels and keywords to isolate recurring failures.
• Configuration and environment variable troubleshooting: Enumerate and verify deployment variables to resolve connection issues, missing secrets, or incorrect settings.
• Common failure pattern playbooks: Trace DAG import failures, task failures, resource exhaustion (including memory issues), connection/credential errors, and UI/health problems to likely causes.

Quick Start

Run an error-focused triage by inspecting the deployment and then pulling the most relevant error logs for the failing deployment ID.