mo-tool 高级诊断与离线检查

mo-tool 是 MatrixOne 源码树中的开发与诊断工具,不是单机 mo_ctl。以下命令对应 main 源码;发行包可能不包含该二进制或全部命令。记录工具与 MO commit,并优先用相同版本构建。

构建与发现命令

准备与 MO 构建一致的 Go、C/C++ 及 native 依赖,从源码根目录执行:

make mo-tool
./mo-tool --help
./mo-tool inspect --help
./mo-tool debug goroutine --help
./mo-tool dashboard --help
./mo-tool object --help
./mo-tool ckp --help

inspect 是高级在线维护入口;先查看其子命令帮助、访问方式和副作用。不要把 help 成功视为命令已在集群执行。

goroutine:采集、分组、判断

先通过配置的调试端口采集文本堆栈:

curl -fsS 'http://127.0.0.1:12345/debug/pprof/goroutine?debug=2' -o goroutines.txt
./mo-tool debug goroutine

在交互提示符依次输入:

parse goroutines.txt
count
group
top 10
exit

按时间间隔重复采集,比较同类调用栈数量是否持续增长,并与 SQL、事务、CPU 和内存指标关联。单次堆栈不能证明泄漏;parse/count 成功也不能证明根因。CPU、block、mutex 采集见 profiling 参数。

Grafana 面板

./mo-tool dashboard create --help
./mo-tool dashboard list --help

配置实际 Grafana 地址、认证、mode 和数据源后创建,再 list 检查面板 UID,并在 Grafana 检查真实指标是否返回。local/cloud/k8s/cloud-ctrl 模式不同;面板创建成功不证明 Prometheus 已采集。删除命令会修改 Grafana 内容,先核对 UID 和文件夹。

checkpoint 与对象文件

对备份副本或受保护的检查目录操作,保留原始文件;读取活跃存储时需评估 GC 与检查点变化。

./mo-tool ckp info ./mo-data/shared2 --local2
./mo-tool ckp view ./mo-data/shared2 --local2
./mo-tool ckp show-create-table --table-id=272387 ./mo-data/shared2 --local2
./mo-tool ckp dump --table-id=272387 -o table.csv ./mo-data/shared2 --local2

本地示例使用 DISK-V2 的 shared2 数据目录和 –local2;按真实 fileservice 路径和 backend 选择,CRC DISK 不使用 –local2。checkpoint 工具会在用户目录 .mo-tool 写日志,需要可写日志目录。table-id 是示例,先用 viewer 确认实际表。默认 CSV 无 header,NULL 为 \N;逻辑导出应用所选 checkpoint 的 tombstone,排除隐藏列,并依赖 catalog 元数据。元数据无法精确解析时应失败,不能猜测 schema。历史时间使用该版本帮助中的 --ts PHYSICAL:LOGICAL。lexical 排序会缓存行,更适合小规模比对。

./mo-tool ckp info --fs-config etc/launch-minio-local/tn.toml --fs-name SHARED
./mo-tool object info object-name --fs-config etc/launch-minio-local/tn.toml --fs-name SHARED

替换实际配置和对象名。远程 key-prefix 指向 MO 数据根目录而非 ckp 子目录,否则可能找到 checkpoint 却无法读取表对象。完整参数和内部格式边界见源码 README。

离线导出不是完整数据库备份:不承诺恢复所有 WAL、权限、租户和运行配置。在独立目标按 schema 导入 CSV,比较主键、字段、NULL 和选定快照;保留导出时间与工具版本。生产灾备使用备份恢复流程。