drt-analyze 是用于分析 DRT CockroachDB 集群健康的工具,针对给定时间范围重建操作时间线,检查 CockroachDB 指标(可用性、延迟、存储等),生成带证据的分层健康报告,并支持交互式下钻。
用途与调用:命令为 /drt-analyze cluster:<name> from:<time> to:<time>。cluster 必填;from 必填,可用 now-4h、now-12h 或 UTC 绝对时间;to 可选,相对时间默认 now,绝对时间默认为 from + 4h。使用前需 Datadog 认证:roachdev datadog auth login(可用 roachdev datadog auth status 验证),认证失败应停止并请用户重新认证。
时间范围限制:窗口超过 24 小时会被拒绝,因为 Datadog 会将其平均为多小时分箱,降低尖峰检测精度并截断操作时间线;建议收窄到 4-24 小时或分多次分析,4 小时窗口粒度最佳(约 1 分钟数据点)。
工作流程:先校验集群存在,再并行启动三个子代理:操作时间线(通过 Datadog 事件重建操作,解析 run、cleanup、failed、dependency-check 查询,生成摘要、时间线、失败项与 DISRUPTIVE_WINDOW 行)、指标健康检查(分批查询集群级可用性、每节点可用性与网络、性能与异常检测、每节点资源、磁盘容量、存储健康、changefeed、作业、goroutine 与准入控制、LSM 与 KV Prober,并按阈值给出 CRITICAL/WARNING/INFO)、日志分析(先做错误与警告模式发现及每主机错误量,再做 panic、OOM、节点重启、fatal、磁盘/WAL 停顿、closed timestamp 回退、CDC 违规等关键信号搜索,然后对异常模式下钻分类)。最后综合三个代理结果做时间关联,仅当发现项起始时间落在操作窗口内才归因,结合操作影响映射判断为 expected 或 CRITICAL。
限制:依赖 Datadog 认证与 roachdev 工具链;资料未提供独立安装步骤、价格、支持平台或效果承诺。