SuperAPI AI 工具集

dt-app-dashboards

数据与分析

查看项目

更新于 10-15 21:36

技能介绍

用途:创建、修改、查询或分析 Dynatrace 仪表板。仪表板是以 JSON 文档形式存储在 Document Store 中,包含磁贴(内容/可视化)、布局(网格定位)和变量(动态查询参数)。

结构要点:顶层含 name、type、content;content 内有 version、variables、tiles、layouts。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。

创建/更新流程(强制顺序):生成查询前先加载领域技能,不要自行编造 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 }。单选过滤 service.name == $Service,多选过滤 in(service.name, array($Service))。类型有 query(DQL 填充)、csv(静态列表)、text(自由文本)。完整参考见 references/variables.md。

限制:资料未提供价格、平台支持范围或具体效果数据;使用需依赖 dtctl 工具与相应参考文档。