Dynatrace

Dynatrace for AI

AI エージェントが Dynatrace を活用するために必要なすべてを、スキルから始めましょう。

スキルは、Agent Skills のオープンな形式に準拠した、持ち運び可能なナレッジパッケージです。AI コーディングエージェントに、Dynatrace のデータをクエリ、分析、解釈するためのドメイン固有のコンテキストを提供します。Claude Code、GitHub Copilot、Cursor、OpenCode、Gemini CLI、およびほかの30以上の互換ツールで利用できます。

インストール

スキルパッケージ（skills.sh）

npx skills add dynatrace/dynatrace-for-ai

Claude Code、Cursor、Cline、GitHub Copilot、OpenCode、およびその他の互換エージェントで利用できます。

Claude Code プラグイン

claude plugin install dynatrace@claude-plugins-official

対話形式で参照する場合は、Claude Code で /plugin を実行し、Discover タブを開いて「Dynatrace」を検索してください。

このプラグインにはスキルに加えて、Dynatrace MCP サーバーも含まれています。Claude Code の起動前に、以下の環境変数を設定して環境に接続してください。

export DT_ENVIRONMENT=https://<env>.apps.dynatrace.com   # e.g. https://abc12345.apps.dynatrace.com
export DT_PLATFORM_TOKEN=<your-platform-token>

次のコマンドで動作を確認してください。

claude mcp login plugin:dynatrace:dynatrace

Platform Token を使用して MCP Server を使う際に必要なスコープの全一覧については、Dynatrace MCP サーバーのドキュメント を参照してください。

プラグインを更新するには、次のコマンドを使用します。

claude plugin marketplace update
claude plugin update dynatrace@claude-plugins-official

注：バンドルされている MCP サーバーは、Dynatrace 環境に接続します。データの取り扱いについては、Dynatrace のプライバシーポリシーをご覧ください。

Cursor プラグイン

Dynatrace プラグインはCursor Marketplaceに掲載されています。インストールは GUI からのみ可能です。Cursor のサイドバーで Customize を開き、「Dynatrace」を見つけて Install を選択し、プロジェクトまたはユーザーのスコープを選んでください。

Cursor の起動前に、上記と同じ DT_ENVIRONMENT および DT_PLATFORM_TOKEN 環境変数を設定してください。

手動

スキルディレクトリをエージェントのスキルパス（.agents/skills/、.claude/skills/、.cursor/skills/ など）にコピーします。

Dynatrace への接続

スキルが提供するのはナレッジのみです。ライブクエリの実行や環境の管理には、ツールと組み合わせてください。

Dynatrace CLI（dtctl）

dtctl は、Dynatrace プラットフォーム向けの kubectl スタイルの CLI です。エージェントに操作方法を教える独自のエージェントスキルが付属しています。

brew install dynatrace-oss/tap/dtctl                        # Install
dtctl auth login --context my-env \
  --environment "https://<env>.apps.dynatrace.com"           # Authenticate
npx skills add dynatrace-oss/dtctl                           # Install the dtctl skill
dtctl doctor                                                 # Verify setup

または、dtctl を使って dtctl スキルをインストールできます：dtctl skills install

Dynatrace MCP サーバー

Dynatrace MCP サーバー は、MCP 経由で Dynatrace API にアクセスできます。Claude Code プラグインには MCP サーバーの設定が自動的にバンドルされているため、上記のように DT_ENVIRONMENT と DT_PLATFORM_TOKEN を設定するだけで利用できます。MCP をネイティブでサポートするほかのエージェントについては、MCP サーバーのドキュメントをご覧ください。

MCP サーバーはリモートです。Dynatrace がホストしているため、インストールは不要です。リリースは io.github.Dynatrace/dynatrace-for-ai として公式 MCP レジストリに公開されるため、レジストリを読み込む MCP ホストでは、名前を指定して追加できます。

スキル

DQL とクエリ言語

スキル	説明
dt-dql-essentials	DQL の構文ルール、よくある落とし穴、クエリのパターンを説明します。DQL を書く前に読み込んでください。

オブザーバビリティ

スキル	説明
dt-obs-services	.NET、Java、Node.js、Python、PHP、Go のサービス RED メトリクスとランタイムテレメトリー。
dt-obs-frontends	リアルユーザーモニタリング、Web Vitals、ユーザーセッション、モバイルのクラッシュ、フロントエンドのエラー。
dt-obs-tracing	分散トレース、スパン、サービス依存関係、障害の検出。
dt-obs-hosts	ホストとプロセスのメトリクス：CPU、メモリ、ディスク、ネットワーク、コンテナ。
dt-obs-kubernetes	Kubernetes クラスター、ポッド、ノード、ワークロード、ラベル、リソース間の関係。
dt-obs-aws	AWS リソース：EC2、RDS、Lambda、ECS/EKS、VPC、ロードバランサー、コスト最適化。
dt-obs-azure	Azure リソース：VM、VMSS、SQL Database、Storage、AKS、App Service、Functions、VNet、Event Hubs、Container Apps、Key Vault。
dt-obs-gcp	GCP リソース：Compute Engine、GKE、Cloud Run、Pub/Sub、VPC、DNS、IAM、Secret Manager。
dt-obs-logs	ログクエリ、フィルタリング、パターン分析、ログ相関。
dt-obs-problems	問題エンティティ、根本原因分析、影響評価、問題相関。
dt-obs-predictive-analytics	ホスト、サービス、インフラストラクチャ全体の時系列予測、キャパシティ飽和計画、傾向／異常検知。
dt-alerting	エンドツーエンドのアラートライフサイクル：異常検知器の設定、Grail のアラートイベント、問題のグループ化、ワークフローの通知ルーティング。
dt-obs-analytics	Davis アナライザーを使用して Dynatrace のダッシュボードとノートブックを分析：異常検知、新規性スコアリング、メトリクス相関。
dt-obs-ext-monitors	プラットフォームのイベント取り込み API 経由で、サードパーティのテスト結果とモニター結果を Dynatrace Grail に取り込みます。
dt-obs-genai	GenAI アプリケーションのオブザーバビリティシグナルを分析：ゴールデンシグナル、LLM のコスト／トークン分析、エージェントのツール呼び出し動作、評価結果。
dt-obs-log-semantic-mapping	ベンダーのログペイロードまたはライブで取り込まれたイベントを使用して、監査ログ連携向けのセマンティック辞書マッピングを提案し、検証します。
dt-obs-network-devices	SNMP で監視されるネットワークデバイス（スイッチ、ルーター、ファイアウォール、ロードバランサー）を分析：トポロジー、インターフェースメトリクス、SNMP トラップ／syslog イベント。
dt-obs-network-flows	OneAgent、NetFlow/IPFIX/sFlow、クラウド VPC フローログのネットワークフローを分析：通信量上位のホスト、通信依存関係、接続状態。

セキュリティ

スキル	説明
dt-sec-insights	security.events のセキュリティデータをクエリして分析します。ランタイム脆弱性分析、ランタイムアプリケーション保護、自動検知（MITRE ATT&CK）、セキュリティポスチャ管理（KSPM/CSPM）が対象です。
dt-sec-contextualization	セキュリティシグナルと IoC の一致をランタイムエンティティに関連付け、共有ランタイムエンティティを通じてトポロジーの各レベルにわたる検出結果を結び付けます。
dt-sec-ioc-hunting	ログとスパンから脅威インテリジェンスの侵害指標をハンティングし、脅威エクスポージャースコアを生成します。
dt-sec-semantic-mapping	ベンダー API のサンプルまたはライブイベントを使用して、新しいセキュリティインテグレーションのセマンティック辞書マッピングを提案し、検証します。
dt-obs-compliance-assistant	EU DORA コンプライアンスの状況を監視し、調査します。コンプライアンススコア、重要機能（CIF）の健全性、インシデント分類、ICT リスクの入力が対象です。

インストルメンテーションのセットアップ

スキル	説明
dt-setup-oneagent	VM、Kubernetes、AWS Lambda、Windows ホスト、リモート EC2 インスタンス、Azure VM/VMSS に Dynatrace OneAgent をインストールするためのリファレンスです。
dt-setup-android	既存の Android プロジェクト（Kotlin または Java）に Dynatrace Mobile Agent をインストルメントします。Gradle プラグイン、エージェント設定、ユーザーのプライバシーオプトインが対象です。
dt-setup-flutter	Dynatrace Flutter Plugin を統合します。依存関係の設定、構成、SDK の初期化、ナビゲーショントラッキング、検証が対象です。
dt-setup-ios	Swift Package Manager を使用して Dynatrace iOS SDK をセットアップします。SPM の依存関係、Dynatrace.plist の構成、プライバシーオプトイン、Xcode のビルド検証が対象です。
dt-setup-react-native	ベア React Native と Expo 向けに Dynatrace React Native Plugin を統合します。依存関係の設定、dynatrace.config.js、Babel 登録、ナビゲーショントラッキング、検証が対象です。

プラットフォーム

スキル	説明
dt-app-dashboards	Dynatrace ダッシュボードを作成、変更、分析します。タイル、レイアウト、変数、可視化が対象です。
dt-app-notebooks	Dynatrace ノートブックを作成、変更、分析します。セクション、DQL クエリ、分析ワークフローが対象です。
dt-js-runtime	Dynatrace のサーバーサイド JavaScript ランタイムです。関数コントラクト、ランタイム制限、Web API、Node.js モジュール、@dynatrace-sdk/* カタログが対象です。
dt-platform-costs	DQL を使用して Dynatrace テナントの実際の請求データと使用量データをクエリし、分析します。DPS 消費量の内訳、コストで正規化した支出ランキング、チャージバック／ショーバック、コスト要因、エンティティレベルのコスト詳細分析が対象です。

移行

スキル	説明
dt-migration	従来のエンティティベースの DQL とトポロジーナビゲーションを、Smartscape の同等機能に移行します。

プロンプト

プロンプトは、Dynatrace の一般的なワークフローで再利用できるタスクテンプレートです。/prompts/ ディレクトリからコピーして、任意の AI チャットに直接貼り付けられます。VS Code／GitHub Copilot を使用する場合は、プロンプトを .github/prompts/ にコピーすると、スラッシュコマンドとして使用できます（例：/troubleshoot-problem）。

各プロンプトは、上記の関連スキルを参照します。最良の結果を得るため、まずそれらのスキルを読み込んでください。

プロンプト	説明
dt-daily-standup	1 つ以上のサービスについて、毎日のスタンドアップレポートを生成します。
dt-health-check	本番環境のサービスの健全性を確認します。
dt-incident-response	トリアージ、根本原因の特定、共有可能なレポートの作成を通じて、進行中の本番環境インシデントに対応します。
dt-investigate-error	Davis Problems を起点として、最近のエラーを調査します（問題 → ログ → トレース）。
dt-performance-regression	最近のデプロイによってパフォーマンスが低下したかどうかを分析します。
dt-troubleshoot-problem	構造化されたログとトレースの調査を通じて、既存の Dynatrace の問題をトラブルシューティングします。

スキルの仕組み

スキルは Agent Skills 仕様に従い、段階的開示を使用します。

1. カタログ - エージェントは、利用可能なスキルを把握するために name と description のみを読み込みます（スキルあたり約 100 トークン）。
2. 手順 - 関連する場合、SKILL.md 全体が読み込まれます（5000 トークン未満）。
3. リソース - references/ 内の詳細なリファレンスファイルが、必要に応じて読み込まれます。

負担なくすべてのスキルをインストールできます。エージェントは必要なものだけを読み込みます。

貢献

スキルの内容（skills/）は Dynatrace 内部で管理され、定期的にここで公開されます。スキルファイルを変更する PR は受け付けられません — 変更を提案する場合は、代わりに issue を作成してください。直接貢献できる内容については、CONTRIBUTING.mdを参照してください。

ライセンス

Apache-2.0