Smartscape Migration スキル

このスキルは、Dynatrace クラシック型および Gen2 エンティティベースの DQL クエリとクエリパターンを Smartscape ベースの同等物に移行します。

最終的な DQL を作成する前に dt-dql-essentials スキルを読み込んでください。そうすることで、翻訳されたクエリが現在の DQL 構文ルールにも従うようになります。

このスキルは Smartscape 指向の DQL 移行のみに焦点を当てています。アセットレベルの移行ワークフローは扱いません。

クエリ目的の分類

ここから開始してください。 正しい移行戦略は、クラシック型の構文がどれであるかではなく、クエリが実際に何をしようとしているかによって異なります。

3 つの異なる状況があります：

#	状況	クラシック型のアンチパターン	移行戦略
1	エンティティ条件でフィルタリングされたマスデータクエリ	タイムシリーズ、ログ、またはメトリクスクエリの filter: 内に classicEntitySelector(...) をインラインで指定	エンティティ条件を生データディメンションに最初に解決します。Smartscape はフォールバックであり、デフォルトではありません。
2	エンティティサブクエリを使用したマスデータクエリのフィルタリング	外側のマスデータクエリをフィルタリングするために in [...]、lookup [...]、join [...] 内で fetch dt.entity.* を使用	同じディメンションファースト戦略を使用します。生データディメンションフィルタまたは in [smartscapeNodes ...] サブクエリとして書き直します。
3	純粋なエンティティリストクエリ	fetch dt.entity.* をスタンドアロンで、または主要な結果ソースとして使用	smartscapeNodes が唯一の有効なパスです。生データディメンションの代替手段は存在しません。

判断：

• 状況 1 または 2 — references/mass-data-filtering-strategy.md を読み込み、フィールド発見 (ステップ 2) と同等性検証 (ステップ 4) を含む すべてのステップ を完了してください。fieldsSnapshot ゲートをスキップしないでください。これらがどのアプローチが実行可能かを判定します。エンティティ型マッピングまたはリレーションシップトラバーサルが Smartscape サブクエリを完成させるために必要な場合にのみ、以下の移行ワークフローにフォールバックしてください。
• 状況 3 — 移行ワークフロー以下とエンティティマッピングテーブルを進めてください。

注：状況 3 には、fetch dt.entity.* によって返されるエンティティをフィルタリングするために classicEntitySelector が使用されるサブケースがあります。これはレアケースであり、同じ smartscapeNodes パスに従います。セレクタ条件を references/mass-data-filtering-strategy.md のステップ 1B を使用して解決してから、smartscapeNodes 内のノードフィルタとして適用します。

移行ワークフロー

状況 3 (純粋なエンティティリストクエリ) および状況 1 と 2 で Smartscape サブクエリを構築する場合、この順序に従ってください：

1. クラシック型の入力パターンを特定します：
   • fetch dt.entity.*
   • classicEntitySelector(...)
   • belongs_to[...]、runs[...]、instance_of[...] などのリレーションシップフィールドアクセス
   • dt.entity.* を使用するシグナルまたはイベントクエリ
2. 関連するクラシック型エンティティタイプを特定します。
3. 以下のコアエンティティマッピングテーブルで Smartscape の置換を検索します。
4. どのクラシック型 DQL コンストラクトを明示的に移行する必要があるかを確認します。
5. Smartscape プリミティブを使用してクエリを書き直します：
   • smartscapeNodes
   • smartscapeEdges
   • traverse
   • references
   • getNodeName()
   • getNodeField()
6. 特殊なケース、サポートされていないエンティティ、または ID の仮定を確認します。
7. 特定のエンティティファミリーまたは移行パターンの詳細な参照を読み込みます。

完全な移行プロセスと出力期待については、references/migration-workflow.md を読み込んでください。

コアエンティティマッピングテーブル

一般的な移行にはこのコンパクトテーブルを最初に使用してください。完全なマッピングセットについては、references/type-mappings.md を読み込んでください。

クラシック型 / Gen2 エンティティ	Smartscape フィールド	Smartscape ノードタイプ	注記
dt.entity.host	dt.smartscape.host	HOST	標準ホストマッピング
dt.entity.service	dt.smartscape.service	SERVICE	標準サービスマッピング
dt.entity.process_group_instance	dt.smartscape.process	PROCESS	プロセスインスタンスは直接マッピング
dt.entity.container_group_instance	dt.smartscape.container	CONTAINER	コンテナグループインスタンスは直接マッピング
dt.entity.kubernetes_cluster	dt.smartscape.k8s_cluster	K8S_CLUSTER	Kubernetes クラスタ
dt.entity.kubernetes_node	dt.smartscape.k8s_node	K8S_NODE	Kubernetes ノード
dt.entity.kubernetes_service	dt.smartscape.k8s_service	K8S_SERVICE	Kubernetes サービス
dt.entity.cloud_application	複数のワークロードフィールド	複数の K8S ワークロードノードタイプ	複数のワークロードタイプにマップされます。クラウドアプリケーションガイドを読み込んでください
dt.entity.cloud_application_instance	dt.smartscape.k8s_pod	K8S_POD	クラシック型クラウドアプリケーションインスタンスはポッドになります
dt.entity.cloud_application_namespace	dt.smartscape.k8s_namespace	K8S_NAMESPACE	ネームスペースマッピング
dt.entity.application	dt.smartscape.frontend	FRONTEND	フロントエンドアプリケーションマッピング
dt.entity.aws_lambda_function	dt.smartscape.aws.lambda_function	AWS_LAMBDA_FUNCTION	クラウド関数エンティティマッピング

移行中に検査する DQL コンストラクト

これらのクラシック型コンストラクトは通常、明示的な書き直しが必要です：

クラシック型コンストラクト	典型的な Smartscape 置換	注記
entityName(x)	name または getNodeName(x)	ノードを直接クエリする場合は name を優先します
entityAttr(x, "...")	直接ノードフィールドまたは getNodeField(x, "...")	利用可能な場合は直接フィールドを優先します
classicEntitySelector(...)	ノードフィルタプラス traverse	制約のある側から開始します。マスデータクエリについては最初に mass-data-filtering-strategy.md を参照してください
シグナルクエリ内の dt.entity.*	dt.smartscape.*	by、filter、fieldsAdd、expand など関連するクローズに適用されます
belongs_to[...]、runs[...]、instance_of[...]	traverse または references[...]	references は静的エッジでのみ機能します
クラシック型エンティティ ID フィルタ	Smartscape id	クラシック ID をむやみに再利用しないでください
affected_entity_ids および affected_entity_types	smartscape.affected_entity.ids および smartscape.affected_entity.types	Smartscape イベントフィールドを使用します

詳細な関数ごとのガイドについては、references/dql-function-migration.md を読み込んでください。

特殊なケース

これらのパターンを文字通りに変換しないでください：

• ホストグループ — スタンドアロンの Smartscape エンティティはありません。HOST のフィールドを使用してください
• プロセスグループ — スタンドアロンの Smartscape エンティティはありません。PROCESS のフィールドを使用してください
• コンテナグループ — スタンドアロンの Smartscape エンティティはありません。必要に応じてプレースホルダーで出力形状を保持してください
• クラシック型 ID — クラシック型エンティティ ID は自動的に Smartscape に引き継がれません
• 計画済み、欠落、または計画されていないマッピング — 直接サポートを仮定する前に完全なマッピングテーブルを確認してください

これらのパターンを移行する前に references/special-cases.md を読み込んでください。

エンティティ別ガイド

移行が特定のエンティティファミリーに焦点を当てている場合、対応する詳細ガイドを読み込んでください：

• references/entity-host.md
• references/entity-service.md
• references/entity-process.md
• references/entity-container.md
• references/entity-kubernetes.md
• references/entity-cloud-application.md

各ガイドは以下を説明しています：

• クラシック型エンティティが何を表していたか
• Smartscape の置換は何か
• 通常どのフィールドが変わるか
• リレーションシップをどのように移行するか
• 一般的な例とピットフォール

参照

• references/README.md — 参照インデックスと読み取りガイド
• references/mass-data-filtering-strategy.md — 状況 1 と 2 についてここから開始してください。 必須ステップ：条件を解決、fieldsSnapshot 発見を実行、アプローチを選択、クエリを作成、同等性を検証
• references/auto-tagging-field-mapping.md — オートタギングルール条件キーをセマンティック辞書フィールド (マスデータおよび Smartscape ノード属性) にマップします
• references/entity-selector-predicates.md — classicEntitySelector 式の完全な述語語彙
• references/migration-workflow.md — エンドツーエンドの移行プロセスと出力期待
• references/type-mappings.md — クラシック型から Smartscape へのタイプおよびフィールドマッピング完全版
• references/dql-function-migration.md — クラシック型 DQL 関数とパターンを移行する方法
• references/relationship-mappings.md — 有効な Smartscape エッジとトラバーサルガイダンス
• references/special-cases.md — 非文字通りおよびサポートされていないエンティティ移行
• references/quick-reference.md — コンパクトなルールと注意点
• references/examples.md — 移行前後の例