# dt-migration

Скилл помогает переписать классические и Gen2-запросы Dynatrace DQL на модель Smartscape. Полезен при миграции старых фильтров сущностей и выборок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2400 установок · ★ 167
- Автор: Dynatrace
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-migration/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/dt-migration

## Что делает

Скилл разбирает классические DQL-запросы к сущностям Dynatrace и переводит их в синтаксис Smartscape. Он разделяет миграцию на три сценария: фильтрация больших массивов данных, использование подзапросов с сущностями и прямые списки через `smartscapeNodes`. При работе с логами и метриками инструмент сначала проверяет прямые фильтры по измерениям сырых данных, а не переносит всё в Smartscape без разбора.

Внутри заложены правила сопоставления типов и конструкций: замена `classicEntitySelector`, преобразование связей `runs` или `belongs_to` в обход через `traverse`, а также вызовы `getNodeName` вместо устаревших функций. Сущности вроде `HOST` или `PROCESS` получают прямые соответствия, тогда как группы хостов переводятся в атрибуты родительских узлов.

Скилл отвечает только за логику запросов DQL и не охватывает миграцию настроек на уровне ассетов. Перед финальной записью DQL потребуется предварительно подключить скилл `dt-dql-essentials`, иначе итоговый запрос может нарушить актуальные синтаксические правила платформы.

## Требования
- Работает с: Dynatrace

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/dt-migration/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/dt-migration/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/dt-migration/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/dt-migration/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dynatrace/dynatrace-for-ai dt-migration
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/dt-migration/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Dynatrace/dynatrace-for-ai --path skills/dt-migration
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/dt-migration/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-migration/SKILL.md

## Когда брать
- переписать выборки `fetch dt.entity.*` на вызовы `smartscapeNodes`
- заменить фильтры `classicEntitySelector` на условия по измерениям
- перевести связи `belongs_to` и `runs` в операции `traverse`
- заменить вызовы `entityName` и `entityAttr` на актуальные функции узлов

## Примеры запросов агенту
- Переведи запрос с `fetch dt.entity.host` на выборку через `smartscapeNodes`.
- Перепиши фильтр с `classicEntitySelector` в запросе метрик на прямые измерения.
- Обнови связи `runs[...]` и вызовы `entityName` в DQL под синтаксис Smartscape.

## Похожие
- [dtctl](https://affpapa.org/nevibecode/skills/dtctl.md) — скилл · 1300 установок
- [Dynatrace Expert](https://affpapa.org/nevibecode/agents/dynatrace-expert.md) — субагент · ★ 40418
- [arize-phoenix-migration](https://affpapa.org/nevibecode/skills/arize-phoenix-migration.md) — скилл · 467 установок
- [tigris-s3-migration](https://affpapa.org/nevibecode/skills/tigris-s3-migration.md) — скилл · 3100 установок
- [d1-migration](https://affpapa.org/nevibecode/skills/d1-migration.md) — скилл · 1200 установок
- [migration](https://affpapa.org/nevibecode/skills/adobe-migration.md) — скилл · 918 установок

Из того же набора: [dynatrace/dynatrace-for-ai](https://affpapa.org/nevibecode/by/dynatrace/dynatrace-for-ai.md) — 29 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md