AIKraft/Skills/debugging-mwaa-workflow

debugging-mwaa-workflow

Диагностирует и устраняет причины сбоев в Amazon MWAA (Provisioned и Serverless) через API, CloudWatch и get-environment. Помогает при ошибках DAG, падении воркеров, проблемах с IAM и зависимостями. Не подходит для создания или тестирования.

AMAmazon official Разработка ★ 2.9k

Что делает навык

Навык диагностирует и определяет первопричину сбоев в Amazon MWAA (Provisioned и Serverless), анализируя логи, API и конфигурацию среды. Он помогает устранить ошибки DAG, падения воркеров и проблемы с зависимостями, предоставляя четкий план исправления.

Когда применять

  • Диагностика причины падения конкретного DAG-запуска или задачи в Provisioned MWAA.
  • Анализ сбоев в Serverless MWAA, где отсутствует веб-интерфейс Airflow.
  • Исследование проблем с импортом модулей или зависимостей после обновления среды.
  • Обследование причин, по которым DAG не появляется в интерфейсе (ошибки парсинга, задержки синхронизации).

Как работает

  1. Определите тип среды (Provisioned или Serverless) по имени или ARN и оцените сложность сбоя.
  2. Выполните шаг 1: выявите неудачные запуски и задачи через API (invoke-rest-api для Provisioned, list-workflow-runs для Serverless).
  3. На шаге 2 получите детали ошибок из логов CloudWatch и классифицируйте их (инфраструктура, дрейф, код-данные).
  4. На шаге 3 проверьте контекст причины, используя справочник каталога сбоев (failure-catalog.md).
  5. На шаге 4 сформируйте отчет: причина, влияние, немедленное исправление и команды для предотвращения повторения.

Примеры запросов агенту

Почему упал DAG 'daily_etl' вчера вечером в среде MWAA?
Диагностируй ошибку 'Worker SIGKILL' в серверном воркере MWAA.
Почему DAG не отображается в интерфейсе, хотя код не менялся?

Что понадобится

  • Доступ к AWS CLI или AWS MCP server для выполнения команд.
  • Права IAM для чтения логов CloudWatch и метрик MWAA.
  • Локальная установка навыка или доступ к инструменту retrieve_skill для загрузки справочных файлов.

Описание составлено по SKILL.md навыка, сверено 15.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «debugging-mwaa-workflow» из репозитория: # https://github.com/aws/agent-toolkit-for-aws
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r debugging-mwaa-workflow/ ~/.claude/skills/debugging-mwaa-workflow/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.