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. 01创建含 DQL 图表的仪表板
  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（四分之一宽）
  • 两种图块类型：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