用途:面向 Doris 集群的 tablet 与 replica 健康排查,帮助定位副本缺失或不健康、版本滞后、克隆任务积压、磁盘使用不均衡以及单个 tablet 过大等常见问题。
主要能力:
- 快速扫描。执行 SHOW PROC '/cluster_health/tablet_health';、SHOW PROC '/statistic';、SHOW PROC '/tasks'; 查看集群健康、统计与任务队列。
- 分表副本下钻。使用 ADMIN SHOW REPLICA STATUS FROM db.table WHERE ReplicaStatus != 'OK'; 找出异常副本。
- 修复。按优先级执行 ADMIN REPAIR TABLE db.table PRIORITY = 'LOW'; 生产安全;紧急单分区可用 ADMIN REPAIR TABLE db.table PARTITION (p202401) PRIORITY = 'HIGH';。
- BE 侧排查。可运行 ./scripts/doris-debug be-metrics --be http://$BE:8040 --grep "tablet|version|clone" 与 ./scripts/doris-debug log-grep be/log --pack versions。
- 查看 tablet 分布,调用接口 http://$FE:8030/api/tablets_distribution?db=db_name&table=tbl_name。
常见成因与线索:副本缺失表现为 tablet_health 中 Health≠TOTAL;版本滞后表现为 tablet 版本落后 quorum 超过 3;克隆积压表现为 tasks 中 CLONE 队列深度大于 50,可调整 clone_worker_count(config.cpp 默认 3);磁盘倾斜表现为某盘使用率超过 85% 而其他盘低于 50%,相关配置有 balance_load_disk_safe_threshold、storage_high_watermark_usage_percent;单 tablet 过大则对比 compaction_tablet_size_threshold。
限制:资料未提供具体版本兼容范围、权限要求、回滚方式与各命令的完整参数说明;调整 clone_worker_count 及均衡配置存在风险,应谨慎评估。