Dynatrace Dashboard Skill

Overview

Dynatrace dashboards are JSON documents stored in the Document Store containing

tiles (content/visualizations), layouts (grid positioning), and variables

(dynamic query parameters).

When to use: Creating, modifying, querying, or analyzing dashboards.

Dashboard JSON Structure

{

  "name": "My Dashboard",

  "type": "dashboard",

  "content": {

    "version": 21,

    "variables": [],

    "tiles": { "<id>": { "type": "data|markdown", ... } },

    "layouts": { "<id>": { "x": 0, "y": 0, "w": 24, "h": 8 } }

  }

}

• Tile IDs in tiles must match IDs in layouts

• Grid is 24 units wide. Common widths: 24 (full), 12 (half), 6 (quarter)

• Two tile types: markdown (text content) and data (DQL query + visualization)

Optional content properties: settings, refreshRate, annotations

Create/Update Workflow (Mandatory Order)

Carefully follow the workflow described in references/create-update.md.

Key rules:

• Load domain skills BEFORE generating queries — do not invent DQL

• Validate ALL queries before adding to dashboard

• No time-range filters in queries unless explicitly requested by user

• Set name before deploying

• Updating — ALWAYS download first: dtctl get dashboard <id> -o json --plain > dashboard.json, modify, then deploy the downloaded file. Never reconstruct JSON from scratch or inject an id manually — both silently overwrite any UI edits the user made since last deployment.

Visualization Types

• Time-series (require timeseries/makeTimeseries): lineChart, areaChart, barChart, bandChart

• Categorical (summarize ... by:{field}): categoricalBarChart, pieChart, donutChart

• Single value/gauge (single numeric record): singleValue, meterBar, gauge

• Tabular (any data shape): table, raw, recordList

• Distribution/status: histogram, honeycomb

• Maps: choroplethMap, dotMap, connectionMap, bubbleMap

• Matrix: heatmap, scatterplot

Required field types per visualization: references/tiles.md

Variables Quick Reference

{ "version": 2, "key": "Service", "type": "query", "visible": true,

  "editable": true, "input": "smartscapeNodes SERVICE | fields name",

  "multiple": false }

• Single-select: filter service.name == $Service

• Multi-select: filter in(service.name, array($Service))

• Types: query (DQL-populated), csv (static list), text (free-form)

Full variable reference: references/variables.md

References

File

When to Load

create-update.md

Creating/updating dashboards

tiles.md

Tile types, visualization field requirements, settings

variables.md

Variable types, replacement strategies, patterns

analyzing.md

Reading dashboards, extracting queries, health assessment