SuperAPI AI 工具集

altinity-clickhouse-expert

智能体与模型

查看项目

更新于 10-16 03:13

技能介绍

用途:面向 ClickHouse 的故障响应、定期审计与临时排障。技能通过多个聚焦型子代理(常分波次运行)快速定位问题,每个代理直接对 ClickHouse 执行 SQL(经 CLI 或 MCP 后端),由 LLM 分析结果,产出可复现工件和 RCA 风格报告。

使用方式:先选执行后端,且只加载一个后端文档。可本地 spawn/exec 且有 clickhouse-client 时用 BACKEND-CLI.md;无法 spawn/exec、但有 MCP ClickHouse 连接器时用 BACKEND-MCP.md。CLI 优先,进程受限或 clickhouse-client 不可用/连不上时回退 MCP。

协调循环:为关键问题建立工件→波次1跑 overview 分诊→波次2按症状选 2–3 个目标代理→可选波次3做 1–2 个深入(schema/mutations/dictionaries)→最高严重度发现具备具体证据和动作时提前停止→输出单一 RCA 报告与一份整合工件。

主要能力与症状映射:overview 快速健康分诊;memory 处理 OOM/MemoryTracker;merges 处理 parts 压力与合并积压;replication 处理延迟与只读副本;reporting 处理查询性能与延迟;storage 处理磁盘与 IO;errors 处理异常失败;ingestion 处理 INSERT 性能;schema 审查表设计与分区;metrics 关注饱和与关键指标;caches 看缓存效率;dictionaries 看字典健康;mutations 看变更积压;text_log 与 logs 查看服务端及系统日志表。

输出格式:RCA 报告含按严重度排序的摘要、证据、根因、行动建议;有文件系统时写入 reports/<timestamp>-<topic>.md,否则内联给出。安全规则:偏好显式列,系统表可用 SELECT ;默认 LIMIT 100 或更少;_log 查询限时(默认 1 小时、最多 24 小时);用聚合结果而非原始导出。运行参数因后端而异,见 BACKEND-CLI.md / BACKEND-MCP.md。

适用场景:ClickHouse 线上事故排查、周期审计、临时调试。限制:需可用的 ClickHouse 连接与上述后端之一;各代理的具体 SQL 与提示词位于 agents/<name>/ 下的 queries.sql 与 prompt.md,相关资料未提供这些文件内容。