用途:面向 Apache Doris 存算分离(cloud 模式)的故障排查,帮助区分 cloud 模式与 shared-nothing 模式下无意义的操作(如磁盘 rebalance、clone、本地 tablet 修复)。
主要能力:归纳五类常见原因——A 元服务延迟、B 缓存未命中风暴、C 对象存储吞吐饱和、D 计算组不均衡、E cloud 模式配置错误(如误用 shared-nothing compaction 参数导致 BE OOM),并给出对应证据与源码锚点(MetaServiceClient.java、FileCache.cpp、S3FileSystem.cpp、ComputeGroupMgr.java)。
使用方式:先确认 cloud 模式,可执行 SHOW FRONTENDS\G 查看 IsCloudMode 字段(Doris 3.0+),或检查 fe.conf 中的 cloud_unique_id、meta_service_endpoint。10 分钟分诊命令包括 SHOW COMPUTE GROUPS\G、SELECT * FROM information_schema.file_cache_stats;、./scripts/doris-debug be-metrics --be http://$BE:8040 --grep "file_cache|local_cache"、./scripts/doris-debug log-grep be/log --query-id "$QID",以及 grep -r "SlowDown|503|Throughput.*exceed" be/log/。元服务健康检查可用 curl -s "http://$MS_HOST:$MS_PORT/api/health"。
调优参考:批量导入后可用 SELECT COUNT(*) FROM new_table; 预热文件缓存;be.conf 可配置 file_cache_path、file_cache_type(whole_file_cache 或 sub_file_cache)、s3_max_connections、s3_request_timeout_ms。
限制:资料未提供具体版本兼容范围、性能提升幅度与完整参数默认值,实际效果需结合环境验证。