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.