SuperAPI AI 工具集

altinity-expert-clickhouse-overview

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:回答“这台服务器是否健康、下一个该深入看哪个方向?”。基于 system.metrics、system.asynchronous_metrics、system.parts、system.disks、system.tables、system.query_log、system.errors、system.text_log 等系统表。设计上只针对单机;副本间差异交由专项技能处理。若连接模式、集群与时间窗口未定,先运行 altinity-expert-clickhouse-connection。

查询包:checks.sql 含 14 项检查(对象计数、内存与 RAM、主键与字典内存、磁盘占用、复制摘要、系统日志 TTL 与大小、每小时查询错误率、part_log 错误、system.errors 高频码、游离 part、text_log 近期告警、后台池利用率);metrics.sql 含 13 项告警检查(id A3.0.x),仅在越阈值时返回行,空结果为正常,其中 A3.0.4/A3.0.5 有版本分支(@requires version<26.8 / version>=26.8),按版本二选一;ddl_queue.sql 检查 ON CLUSTER DDL 队列(@requires keeper)。

使用方式:从技能目录读取查询包文件;逐条执行语句,不要整文件运行;语句以 ; 结尾并以 -- @check <id> <title> 开头,结果保留 id。遵守 -- @requires:表缺失、需要 keeper 但无 Keeper/ZooKeeper、版本条件不满足时跳过并记录原因。集群宏存在时保留 {cluster},否则按连接技能的改写规则处理;其他 {placeholder} 需替换真实值或跳过。出错时记录检查 id 和错误首行后继续;仅对 UNKNOWN_IDENTIFIER 执行 DESCRIBE TABLE system.<table> 并去掉缺失列。severity 列为该行结论,直接复制,不要重新评级。

限制与判读:无返回行的 metrics 检查视为正常;Minor 行仅供参考。系统日志表无 TTL 属发现项。错误率需区分平稳或突增,忽略本次诊断自身造成的错误码。对象与 part 计数为服务器级,若来自 system.* 表须说明。游离 part 的 broken*/unexpected*/ignored* 提示复制或磁盘问题,clone 与 covered-by-broken 通常可清理。MergesAndMutations 池利用率超 90% 说明合并受容量限制。has_keeper = 0 时复制类与 DDL 队列检查标记为不适用。报告需含表头、Findings 表、OK 检查行、跳过与失败检查段(不可省略)及下一步建议。