gcp-composer-troubleshooting

Diagnose failed Cloud Composer DAGs and generate root cause analysis reports.

1|Updated Aug 30, 2026
One-click install
npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill gcp-composer-troubleshooting-feexsystems
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gcp-composer-troubleshooting
Source: https://github.com/FeexSystems/3WM-SONIK-LABS/tree/main/.gemini/skills/gcp-composer-troubleshooting
Command: npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill gcp-composer-troubleshooting-feexsystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Cloud Composer (Apache Airflow) pipeline fails, finding the root cause requires digging through scattered logs and verifying which DAG code actually ran remotely. This Skill guides a methodical, evidence-based Root Cause Analysis (RCA) so you fix the real problem instead of guessing. ## Core Features & Use Cases - Log-Based Evidence Gathering: Uses gcloud logging read with severity, DAG ID, and task filters to locate failures and stack traces. - Remote Code Verification: Downloads the actual DAG code from the environment's GCS bucket to confirm the remote version matches local files before analysis. - RCA Report Generation: Correlates log errors with exact code lines, proposes fixes, and produces a saved RCA report. - Use Case: Your daily_sales_agg DAG failed yesterday at 2pm. The Skill pulls the error logs, downloads the running DAG code, identifies a KeyError: 'region' at line 45, and recommends record.get('region', 'unknown'). ## Quick Start Ask the agent to troubleshoot why your Composer DAG failed and generate an RCA report, providing the DAG ID and approximate failure time.

Frequently Asked Questions about gcp-composer-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a failed Cloud Composer DAG?▼

Start by gathering the DAG ID, run ID, and task ID, then use gcloud logging read with severity>=ERROR filters scoped to the cloud_composer_environment resource. Correlate the log stack traces with the actual DAG code downloaded from the environment's GCS bucket to pinpoint the failing line.

How to fetch Airflow task logs from Google Cloud Composer?▼

Use gcloud logging read with a filter like resource.type="cloud_composer_environment" combined with labels.dag_id and severity>=ERROR. Add --limit and a time range to narrow results, and format output with timestamp, severity, task_id, and textPayload fields.

Why does my local DAG differ from the one running in Composer?▼

The Composer environment runs code from its GCS bucket, which may not match your local files if syncs were missed. Download the remote DAG with gcloud storage cp to a temporary folder and perform the RCA on the actual running code before applying fixes.

Can this skill automatically fix my broken Airflow DAG code?▼

No, it follows a read-only-first approach: it analyzes logs and remote code to prove the root cause and proposes a fix, but does not modify code unless you explicitly ask. This prevents untested changes from being applied to production pipelines.

What information do I need to start a Composer root cause analysis?▼

Provide the DAG ID and ideally the run ID, task ID, or an approximate failure time. If you only have a vague error, the agent will ask for a DAG ID or time range to search logs effectively.