Навыки database-migrations-migration-observability
📦

database-migrations-migration-observability

Низкий риск ⚙️ Внешние команды🌐 Доступ к сети🔑 Переменные окружения

Создание наблюдаемости миграций и CDC-конвейеров

Миграции баз данных не обеспечивают достаточной видимости прогресса, ошибок и целостности данных. Этот навык предоставляет наблюдаемость корпоративного уровня с метриками в реальном времени, обнаружением аномалий и автоматическим оповещением.

Поддерживает: Claude Codex Code(CC)
📊 69 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «database-migrations-migration-observability». Настроить миграцию MongoDB с метриками

Ожидаемый результат:

Наблюдаемый класс миграции с гистограммами Prometheus для длительности, счетчиками обработанных документов и логированием winston в файл и консоль. Эндпоинт метрик открыт для сбора Prometheus.

Использование «database-migrations-migration-observability». Настроить Debezium CDC для PostgreSQL

Ожидаемый результат:

Конфигурация коннектора Kafka Connect с плагином pgoutput, интервалами heartbeat и метриками для задержки потребителя и задержки репликации. События передаются в топик database.changes.

Использование «database-migrations-migration-observability». Создать дашборд Grafana для миграций

Ожидаемый результат:

Дашборд Grafana с панелями для скорости миграции (строк в секунду), задержки данных в секундах с цветовыми порогами и уровня ошибок во времени. Автоматическое предоставление через Grafana API.

Аудит безопасности

Низкий риск
v1 • 2/24/2026

Static analyzer flagged 24 patterns but all are false positives. The skill uses standard monitoring libraries (prometheus-client, kafka-python, requests) for legitimate observability purposes. Network calls target infrastructure APIs (Kafka Connect, Grafana, Slack webhooks) as expected for monitoring. No shell execution, cryptographic operations, or suspicious patterns found. Minor risk due to network access for webhook integrations.

1
Просканировано файлов
423
Проанализировано строк
4
находки
1
Всего аудитов
Проблемы низкого риска (1)
HTTP requests to external services
Skill makes HTTP requests to Kafka Connect API, Grafana API, and Slack webhooks for monitoring purposes. This is expected behavior for observability infrastructure but requires API credentials.

Факторы риска

⚙️ Внешние команды (1)
🌐 Доступ к сети (3)
🔑 Переменные окружения (1)
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
31
Сообщество
88
Безопасность
91
Соответствие спецификации

Что вы можете построить

Миграции в production без простоев

Мониторинг крупномасштабных миграций баз данных в реальном времени с автоматическим оповещением при превышении порогов задержки данных или скачках уровня ошибок.

Реализация CDC-конвейера

Настройка Change Data Capture из PostgreSQL в целевые системы с помощью Debezium с отслеживанием задержки репликации и пропускной способности событий.

Автоматизация дашбордов миграций

Программная генерация дашбордов Grafana, отображающих прогресс миграции, задержку данных и уровень ошибок с оповещением на основе пороговых значений.

Попробуйте эти промпты

Базовая настройка мониторинга миграций
Create an observable MongoDB migration script with Prometheus metrics for duration and document count. Include structured logging with winston.
CDC-конвейер с Debezium
Set up a Debezium CDC connector for PostgreSQL with Kafka. Configure metrics for events processed, consumer lag, and replication lag.
Обнаружение аномалий и оповещение
Implement anomaly detection for migration throughput and error rates. Send alerts to Slack when throughput drops below 50% of expected or error rate exceeds 1%.
Полный стек наблюдаемости
Create a complete migration observability solution with Prometheus metrics, Grafana dashboard automation, Slack alerting, and CI/CD integration for health checks.

Лучшие практики

  • Всегда используйте транзакции с сессионным выполнением для атомарности миграции и поддержки отката
  • Устанавливайте интервалы heartbeat (10 секунд) в CDC-коннекторах для быстрого обнаружения остановок репликации
  • Настраивайте несколько каналов оповещения (Slack, email) с маршрутизацией на основе серьезности для критических и предупреждающих警报

Избегать

  • Не пропускайте регистрацию метрик - ненаблюдаемые миграции нельзя мониторить на аномалии
  • Избегайте интервалов опроса длиннее 30 секунд для отслеживания прогресса - это задерживает обнаружение аномалий
  • Никогда не передавайте учетные данные в конфигурациях дашбордов - используйте переменные окружения или управление секретами

Часто задаваемые вопросы

Какие базы данных поддерживаются для CDC?
PostgreSQL полностью поддерживается через плагин pgoutput. MongoDB, MySQL и SQL Server требуют дополнительной конфигурации коннектора Debezium.
Как работает обнаружение аномалий?
Система мониторит строки в секунду и уровень ошибок. Оповещения срабатывают, когда пропускная способность падает ниже 50% от ожидаемой или уровень ошибок превышает 1%.
Можно ли использовать это без Kafka?
Базовая наблюдаемость миграций работает без Kafka. CDC-конвейеры требуют Kafka для потоковой передачи событий.
Как создаются дашборды Grafana?
Дашборды автоматически предоставляются через Grafana API с использованием аутентификации bearer token. JSON дашборда генерируется программно.
Какие метрики собираются по умолчанию?
Длительность миграции, обработанные документы/строки, количество ошибок, задержка потребителя и задержка репликации в секундах.
Как интегрироваться с CI/CD?
Используйте предоставленный шаблон рабочего процесса GitHub Actions с шагами проверки состояния, которые проверяют завершение миграции и пороги задержки данных.

Сведения для разработчиков

Структура файлов

📄 SKILL.md