SuperAPI AI 工具集

altinity-expert-clickhouse-metrics

智能体与模型

查看项目

更新于 10-15 16:48

技能介绍

用途:从 system.metrics、system.events、system.asynchronous_metrics、system.metric_log 和 system.asynchronous_metric_log 中读取实时指标与饱和信息,回答“当前哪个资源饱和、一小时前是否也饱和”。若连接模式、集群与时间窗口尚未确定,应先运行 altinity-expert-clickhouse-connection。

主要能力:checks.sql 提供 12 项检查(metrics-01 至 metrics-12,共 14 条语句),覆盖内存、运行中查询与连接的饱和度汇总,负载均值与 CPU 核数对比,复制指标,每分区最大 parts 与插入阈值,后台池利用率,启动以来的失败与限流计数,近 6 小时内存与负载均值,近 1 小时查询速率,块设备队列深度,运行时长与版本,Prometheus 端点配置。metrics-02、metrics-10 各有两个互补版本,分别带 @requires version<26.8 与 version>=26.8,只运行与服务器版本匹配的一条;metrics-07、metrics-08 依赖 system.asynchronous_metric_log,metrics-09 依赖 system.metric_log。

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

限制:饱和度百分比与严重级别由 SQL 计算,直接采用。metrics-06 计数自服务器启动起累计,需结合 metrics-11 的运行时长解读。运行时长不足一小时表示窗口内发生过重启,应先查 system.crash_log 与 system.text_log。metrics-12 未报告 Prometheus 端点属监控缺口而非服务器故障,记为 Minor。