Airflow DAG 深度排障
原名:debugging-dags
对导入失败、解析异常和任务运行失败建立完整根因分析。
中文 Skills 技能说明
适合持续失败或简单看日志无法定位的问题;按复现、日志、依赖、环境、修复和回归形成证据链,不凭经验直接改生产。Airflow、OpenLineage、dbt Core 和本地数据工具可在用户自己的环境使用;Astronomer 托管能力须使用自有合法账户,并确认中国大陆网络、区域、费用和数据位置。执行前读取真实项目、版本和官方资料,输出目标、依据、影响、验证结果与回退方式;没有证据时明确说明未知,不编造数据、配置或成功状态。 创建、修改、部署、发布、迁移、发送、删除或产生费用的操作,必须先展示目标和差异并获得有权限人员确认。 代码、数据库、日志、凭据、邮件、客户和企业资料按敏感内容处理,只读取任务所需范围,上传或外发前完成授权、脱敏和最小化。
上游能力依据
上游原始适用说明:Comprehensive DAG failure diagnosis and root-cause analysis with structured investigation and prevention recommendations. Use when deep failure investigation is needed, a DAG fails to import/parse or 'airflow dags list' errors on a file; a task or run is failing and must be diagnosed and fixed; requests like 'why did X fail', 'my dag keeps failing — find and fix it', or fixing a broken DAG so it loads cleanly. For simple 'why did it fail / show logs', the airflow skill handles it directly.
上游 SKILL.md 主要章节(保留原文标题):
- Running the CLI
- Step 1: Identify the Failure
- Step 2: Get the Error Details
- Step 3: Check Context
- Package version changes
- On Astro
- On OSS Airflow
- Step 4: Provide Actionable Output
- Root Cause
- Impact Assessment
使用边界
先复现问题并固定测试范围,再生成或执行测试。测试通过只能证明已覆盖的场景,不能代替生产环境验收。
作者、翻译与许可证
- 原作者
- Astronomer 与 astronomer/agents contributors
- 中文翻译
- CEOFans翻译
- 许可证
- Apache-2.0
- 上游来源
- https://github.com/astronomer/agents/tree/dbd9bb79c4f7b7ac9c1cdd2b4b75213c81f423e5/skills/debugging-dags
适用范围
平台:linux、macos、windows;标签:测试与质量、Airflow DAG 深度排障
安全提示
基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件,请在最小权限环境中使用,高风险操作必须人工确认。
如发现侵权、许可证或安全问题,可在本页前台提交投诉,管理员复核后可立即下架。