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 (四分幅)
• 2 つのタイルタイプ: markdown (テキストコンテンツ) と data (DQL クエリ + ビジュアライゼーション)

オプションのコンテンツプロパティ: settings、refreshRate、annotations

作成/更新ワークフロー (必須の順序)

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

重要なルール:

• クエリ生成の前にドメインスキルを読み込む — DQL を自作しない
• ダッシュボードに追加する前にすべてのクエリを検証する
• ユーザーが明示的にリクエストしない限り、クエリに時間範囲フィルターを設定しない
• デプロイ前に name を設定する
• 更新時 — 常に先にダウンロードする: dtctl get dashboard <id> -o json --plain > dashboard.json でダウンロードし、変更を加えてからデプロイします。ゼロから JSON を再構築したり、手動で id を注入したりしないでください。どちらもユーザーが最後のデプロイ以降に UI で行った編集を無言のうちに上書きします。

ビジュアライゼーション タイプ

• 時系列 (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	ダッシュボード読取、クエリ抽出、ヘルス評価