用途:创建、修改、查询或分析 Dynatrace Notebook。Notebook 是存储在 Document Store 中的 JSON 文档,content.sections 为有序数组,按数组顺序自上而下渲染。区块类型有 markdown(叙述)和 dql(DQL 查询与可视化),function 类型存在但少见。区块 id 用字符串整数(如 "1"),也接受 UUID。content.defaultTimeframe 设置默认时间范围,各区块可通过 section.state.input.timeframe 覆盖,DQL 中也可硬编码时间过滤。
读取与分析:用 dtctl get notebook <id> -o json 获取完整内容(describe 只返回元数据),再检查 JSON 属性;分析前先阅读 references/analyzing.md。
创建/更新流程(强制顺序):生成查询前先加载领域技能,不要自创 DQL;所有区块查询须先验证再加入 Notebook;部署前设置 name。更新时必须先读取当前状态:dtctl get notebook <id> -o json,保存为 notebook.json,修改该文件后再部署,切勿从零重建 JSON 或手动注入 id,否则会静默覆盖用户在 UI 中的编辑。用 dtctl apply 部署,会自动校验,失败须修复全部报错后重新应用。visualizationSettings 中除非用户指定可视化类型,否则优先 autoSelectVisualization: true;设为 false 时须显式设置 state.visualization。
可视化类型:时间序列(需 timeseries/makeTimeseries)支持 lineChart、areaChart、barChart、bandChart;分类(summarize ... by:{field})支持 categoricalBarChart、pieChart、donutChart;单值/仪表支持 singleValue、meterBar、gauge;表格支持 table、raw、recordView;分布/状态支持 histogram、honeycomb;地理地图支持 choropleth、dotMap、connectionMap、bubbleMap;矩阵/相关性支持 heatmap、scatterplot。各可视化所需字段类型见 references/sections.md。
限制:资料未提供安装方式、收费与平台信息。