mcpField
D
dt-app-dashboards

dt-app-dashboards

github.com/dynatraceデータ・データベース1692.8k 回インストール今日更新
リポジトリ

dt-app-dashboards について

Dynatrace Dashboard Skillは、Dynatraceダッシュボードの作成、更新、検索、分析を行う人向けのスキルです。JSON構造、可視化、変数を説明し、更新前に現状を取得する手順も示します。

主な機能

  1. 01ダッシュボードJSON構造の説明
  2. 02可視化タイプと要件の一覧
  3. 03変数タイプと使い方の説明
  4. 04作成・更新ワークフロー

活用シーン

  1. 01DQLチャートを含むダッシュボードの作成
  2. 02既存ダッシュボードの変更
  3. 03クエリや設定の確認
  4. 04ダッシュボード内容の分析

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dynatrace/dynatrace-for-ai --skill dt-app-dashboards

インストール後、Claude Code で/dt-app-dashboardsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
ExampleDashboard.json
visualization-settings.reference.jsonc
references/
analyzing.md
create-update.md
tiles.md
variables.md

詳細

Dynatrace ダッシュボードスキル

概要

Dynatrace ダッシュボードは、タイル（コンテンツ／可視化）、レイアウト（グリッド上の配置）、変数（動的なクエリパラメーター）を含む、Document Store に保存された JSON ドキュメントです。

使用する場面： ダッシュボードの作成、変更、クエリ、分析。

ダッシュボード JSON の構造

{
  "name": "My Dashboard",
  "type": "dashboard",
  "content": {
    "version": 21,
    "variables": [],
    "tiles": { "<id>": { "type": "data|markdown", ... } },
    "layouts": { "<id>": { "x": 0, "y": 0, "w": 24, "h": 8 } }
  }
}
  • tiles のタイル ID は、layouts の ID と一致する必要があります
  • グリッドの幅は 24 単位です。一般的な幅は 24（全幅）、12（半分）、6（4分の1）です
  • タイルの種類は 2 つです。markdown（テキストコンテンツ）と data（DQL クエリ＋可視化）です

任意のコンテンツプロパティ： settings、refreshRate、annotations

読み取りと分析

dtctl get dashboard <id> -o json を使って全コンテンツを取得します（describe で返されるのはメタデータのみです）。次に JSON を調べ、利用できるプロパティを確認します。分析する前に、references/analyzing.md をよく読んでください。

作成／更新のワークフロー（必須の順序）

references/create-update.md に記載されたワークフローに、注意深く従ってください。

主なルール：

  • クエリを生成する前に、ドメインスキルを読み込みます。DQL を作り出さないでください
  • ダッシュボードに追加する前に、すべてのクエリを検証します
  • ユーザーから明示的に依頼されない限り、クエリに時間範囲フィルターを含めないでください
  • デプロイする前に name を設定します
  • 更新時は、必ず最初に現在の状態を読み取ります： dtctl get dashboard <id> -o json を実行して dashboard.json として保存し、そのファイルを変更してからデプロイします。JSON を一から再構築したり、id を手動で挿入したりしないでください。そうすると、前回のデプロイ以降にユーザーが UI で行った編集が、どちらも気付かれないまま上書きされます
  • dtctl apply でデプロイします。検証は自動的に実行されます。失敗した場合は、報告されたエラーをすべて修正してから再適用します

可視化の種類

  • 時系列（timeseries／makeTimeseries が必要）：lineChart、areaChart、barChart、bandChart
  • カテゴリ（summarize ... by:{field}）：categoricalBarChart、pieChart、donutChart
  • 単一値／ゲージ（単一の数値レコード）：singleValue、meterBar、gauge
  • 表形式（任意のデータ形状）：table、raw、recordList
  • 分布／ステータス：histogram、honeycomb
  • マップ：choroplethMap、dotMap、connectionMap、bubbleMap
  • マトリックス：heatmap、scatterplot

可視化ごとに必要なフィールドの種類：references/tiles.md

変数クイックリファレンス

{ "version": 2, "key": "Service", "type": "query", "visible": true,
  "editable": true, "input": "smartscapeNodes SERVICE | fields name",
  "multiple": false }
  • 単一選択： filter service.name == $Service
  • 複数選択： filter in(service.name, array($Service))
  • 種類：query（DQL で設定）、csv（静的リスト）、text（自由形式）

変数の詳細なリファレンス：references/variables.md

リファレンス

ファイル読み込む場面
create-update.mdダッシュボードを作成／更新するとき
tiles.mdタイルの種類、可視化に必要なフィールド、設定を確認するとき
variables.md変数の種類、置換方法、パターンを確認するとき
analyzing.mdダッシュボードの読み取り、クエリの抽出、健全性の評価を行うとき

コメント

Markdown 対応