# dt-migration

> Claude/Codex skill by [@dynatrace](https://omgskills.com/library/dynatrace/index.md) · 164 stars · Updated 2026-10-01

Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents. Covers three scenarios. (1) mass data queries filtered by classic entity conditions — migrate to direct dimension filters first, Smartscape only as fallback; (2) mass data queries using entity subqueries for filtering — same dimension-first strategy; (3) pure entity list queries — migrate fetch dt.entity.\* to smartscapeNodes. Also handles entityName, entityAttr, classicEntitySelector, and classic relationship patterns.

Tags: agent-skills, ai-agents, claude-code, devops, dql, dynatrace, mcp, observability

## Install

```sh
git clone https://github.com/Dynatrace/dynatrace-for-ai /tmp/dynatrace-for-ai && ln -s /tmp/dynatrace-for-ai/skills/dt-migration ~/.claude/skills/dt-migration
```

## From README

Smartscape Migration Skill This skill migrates Dynatrace classic and Gen2 entity-based DQL queries and query patterns to Smartscape-based equivalents. Load the dt-dql-essentials skill before writing final DQL so the translated query also follows current DQL syntax rules. This skill focuses on Smartscape-oriented DQL migration only. It does not cover asset-level migration workflows. Query Purpose Classification Start here. The correct migration strategy depends on what the query is actually trying to do — not just which classic constructs it uses. There are three distinct situations: | \# | Situation | Classic anti-pattern | Migration strategy | | --- | --- | --- | --- | | 1 | Mass data query filtered by entity conditions | classicEntitySelector(...) inline in filter: of a timeseries, logs, or metrics query | Resolve entity conditions to raw data dimensions first. Smartscape is a fallback, not the default. | | 2 | Mass data query using entity subquery for filtering | fetch dt.entity.

## Links

- HTML page: https://omgskills.com/skills/dynatrace/dynatrace-for-ai/dt-migration/
- GitHub: https://github.com/Dynatrace/dynatrace-for-ai
- Author: [@dynatrace](https://omgskills.com/library/dynatrace/index.md)

## More from this repo

- [dt-obs-analytics](https://omgskills.com/skills/dynatrace/dynatrace-for-ai/skills/dt-obs-analytics/index.md) — Used to analyze dashboards and notebooks using Davis analyzers — anomaly detection, novelty scoring, and correlation.
   - [@dynatrace](https://omgskills.com/library/dynatrace/index.md) · 167 stars
- [dt-obs-compliance-assistant](https://omgskills.com/skills/dynatrace/dynatrace-for-ai/skills/dt-obs-compliance-assistant/index.md) — Used to monitor and investigate EU DORA compliance posture using Dynatrace Compliance Assistant.
   - [@dynatrace](https://omgskills.com/library/dynatrace/index.md) · 167 stars
- [dt-obs-ext-monitors](https://omgskills.com/skills/dynatrace/dynatrace-for-ai/skills/dt-obs-ext-monitors/index.md) — 3rd-party test and monitor result ingestion into Dynatrace Grail via the platform events ingest API...
   - [@dynatrace](https://omgskills.com/library/dynatrace/index.md) · 167 stars