dt-migration

Convert classic Dynatrace DQL queries to Smartscape equivalents.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/mf-dynatrace/dt-mcp-workspace --skill dt-migration-mf-dynatrace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dt-migration
Source: https://github.com/mf-dynatrace/dt-mcp-workspace/tree/main/skills/dt-migration
Command: npx skills add https://github.com/mf-dynatrace/dt-mcp-workspace --skill dt-migration-mf-dynatrace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you migrate Dynatrace classic and Gen2 entity-based DQL queries to Smartscape equivalents, simplifying the transition to Smartscape-based DQL workflows.

Core Features & Use Cases

  • DQL to Smartscape Conversion: Converts entity-based DQL queries to Smartscape-based equivalents for better performance and compatibility.
  • Query Analysis: Analyzes classic DQL queries and provides migration guidance, including entity mapping, relationship traversal, and field replacement.
  • Use Case: Use this Skill to transform complex DQL queries involving entity-based conditions and relationships into Smartscape-based queries that leverage the new Smartscape data model.

Quick Start

Load the dt-migration skill and run the following command to get started:

dt-migration --query 'fetch dt.entity.host | filter in(id, classicEntitySelector("type(host),tag([Environment]syn_grail_log:bastion)")) | fields entity.name, id'

Frequently Asked Questions about dt-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Dynatrace DQL queries to Smartscape equivalents?▼

To convert Dynatrace DQL queries to Smartscape equivalents, you can use a conversion skill that parses classic entity-based queries and transforms entity selectors, relationships, and fields into the new Smartscape data model syntax.

What is the process for migrating classic DQL entity selectors to Smartscape?▼

Migrating classic DQL entity selectors to Smartscape involves parsing the original query, mapping entity types, replacing fields, and traversing relationships to construct a Smartscape-based DQL equivalent that leverages the new data model.

Can I migrate complex DQL queries with entity-based conditions to Smartscape?▼

Yes, you can migrate complex DQL queries with entity-based conditions to Smartscape. The conversion process analyzes the query structure and provides guidance on transforming relationships and filters into Smartscape equivalents.

What do I need to know before converting Dynatrace DQL to Smartscape?▼

Before converting Dynatrace DQL to Smartscape, you need an understanding of the Smartscape data model and DQL syntax, specifically regarding entity selectors, relationship traversal, and field replacement for entity-based queries.

Does DQL to Smartscape conversion work for all query types?▼

DQL to Smartscape conversion applies specifically to entity-based queries involving entity selectors, relationships, and fields. It is designed for classic and Gen2 DQL queries transitioning to Smartscape-based workflows.

Why should I migrate my Dynatrace DQL queries to Smartscape equivalents?▼

You should migrate Dynatrace DQL queries to Smartscape equivalents to achieve better performance and compatibility within Smartscape-based DQL workflows, simplifying the transition to the new data model.