用途:诊断 Dynatrace 租户从 Classic(Gen2)迁移到最新版 Dynatrace(Gen3)的就绪度,并告诉用户应优先修改什么以获得最大收益。检查的 DQL 与 JS 内置在技能目录的 references/readiness-checks.json 中,通过 Grail、settings 与平台 API 执行,无需抓取或依赖仪表盘。
主要能力:先做前置准备与环境校验(dtctl version / dtctl doctor / dtctl ctx),可按平台安装 dtctl(macOS/Linux:brew install dynatrace-oss/tap/dtctl;Windows PowerShell 脚本;其他方式见官方安装指南)并安装 Dynatrace AI skills(npx skills add dynatrace/dynatrace-for-ai,或 Claude Code 插件方式)。配置并验证上下文后,运行 python3 scripts/collect.py --context <name> 对租户执行全部检查,约 1 分钟,输出合并 JSON(含 context、generated、check_count、upgrade_guide、scope_gaps、sections[].checks[],每项有 id、title、type、description、result、status、result_total_rows、error、scopes_needed、skipped)。
使用方式:必须把用户指定的租户作为 --context 传给 collect.py 及每条 dtctl 命令;用户指定时不得回退到当前活动上下文,先确认上下文存在,否则停止并说明。仅在用户未指定时才用活动上下文,并先声明正在评估哪个租户。逐项判定状态:有 status 用 status;否则按 description 中自带的 🟢/🟡/🔴 规则套用 result;空结果或计数 0 视为就绪;出现 error 与 scopes_needed 视为未知,绝不当作就绪。报告需先提示 scope_gaps(缺的 scope 导致部分检查无法运行),按影响排序 🔴 阻塞项再排 🟡,并按检查分区(Log Classic、OpenPipeline、Classic 实体模型、IAM/RBAC、服务检测与 SDv2、云集成、基础设施/OneAgent/Operator、ActiveGate 与网络、Synthetic、DEM、应用安全、REST API、Classic 应用等)组织。对仍使用的 Classic 仪表盘,按 Views/Users 排序列出前约 10–20 个并给出深链,指引使用内置一键转换器(Dashboards Classic 中 > 菜单 → Upgrade),并说明不支持的 tile(USQL、Service、Database、World Map)会变为说明性 markdown 需手工重建。每次运行结束都必须生成自包含 HTML 报告(仅 HTML,无 PDF),保存为 readiness-report-<tenant>-<日期>.html,并在对话中同时展示结论与排序后的首要行动。
适用场景与限制:适用于使用 dtctl 且具备足够授权 scope 的 Dynatrace 租户升级前评估。采集器只读,不会修改租户配置;JSON 中详细列表最多 25 行,真实数量看 result_total_rows;可用 dtctl query / dtctl exec function 单独重跑某检查。dtctl 无法读取 Classic 仪表盘,也不要自行转换;不要编造文档链接,section 无 doc_links 时引用顶层 upgrade_guide。缺失信息:官方未提供具体价格、支持平台细节与检查项完整清单。