dt-migration

Convert classic Dynatrace DQL queries and entity selectors to Smartscape equivalents.

2|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/pvellido1/traces-flow --skill dt-migration-pvellido1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dt-migration
Source: https://github.com/pvellido1/traces-flow/tree/main/.github/skills/dt-migration
Command: npx skills add https://github.com/pvellido1/traces-flow --skill dt-migration-pvellido1

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of converting Dynatrace classic DQL, entity-based navigation, and classic entity selectors to Smartscape-based equivalents, providing users with an efficient and seamless transition between different versions.

Core Features & Use Cases

  • Classic Entity Conversion: Convert classic entity types to Smartscape node types.
  • DQL Rewriting: Rewrite classic entity DQL into Smartscape DQL.
  • Selector Mappings: Migrate entityName(), entityAttr(), classicEntitySelector(), and classic relationship patterns to Smartscape traversal.
  • Use Case: For users looking to transition from classic to Smartscape and want to understand how to map their existing queries and entity selectors.

Quick Start

Load the dt-migration skill before writing your final DQL to ensure your queries follow current DQL syntax rules.

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 classic entity DQL queries to Smartscape equivalents?

To convert Dynatrace classic entity DQL queries to Smartscape equivalents, you rewrite classic entity types into Smartscape node types and map classic selectors to Smartscape traversal patterns. This ensures your queries follow current Smartscape DQL syntax rules.

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

Migrating classic entity selectors to Smartscape DQL involves mapping functions like entityName(), entityAttr(), and classicEntitySelector() to Smartscape traversal equivalents. This transition ensures compatibility with Smartscape node types and relationship patterns.

Do I need to understand Dynatrace DQL syntax to use classic entity conversion?

Yes, you need a solid understanding of Dynatrace DQL syntax and structure to perform classic entity conversion. The migration process relies on recognizing classic entity types and rewriting them into valid Smartscape DQL patterns.

Can I map classic relationship patterns to Smartscape traversal in DQL?

Yes, you can map classic relationship patterns directly to Smartscape traversal in DQL. This conversion handles classic entity relationships and ensures the migrated queries maintain compatibility with Smartscape node structures.

What's the best way to transition Gen2 entity-based structures to Smartscape?

The best way to transition Gen2 entity-based structures to Smartscape is by converting classic entity types to Smartscape node types and rewriting DQL patterns. Loading a migration skill before writing your final DQL ensures seamless mapping.

Why does my migrated Dynatrace DQL query fail in Smartscape?

Migrated Dynatrace DQL queries often fail in Smartscape due to unmapped classic entity selectors or outdated syntax. You must rewrite classic entity types and relationship patterns to match Smartscape traversal equivalents for successful execution.