SuperAPI AI 工具集

clickhouse-managed-postgres-rca

数据与分析

查看项目

更新于 10-15 19:49

技能介绍

用途:当用户在 ClickHouse 托管的 Postgres 实例上报告变慢、CPU 高、吞吐低、缓存抖动或其他不明性能问题时触发,提供基于证据的根因分析(RCA)流程。

主要能力:通过 https://api.clickhouse.cloud 上的两个 API 获取数据,使用 ClickHouse Cloud API key/secret 做 HTTP Basic 认证。Prometheus 指标接口为 postgresInstancePrometheusGet(Prometheus 标签),返回 Prometheus 暴露格式的系统与工作负载指标;慢查询模式接口为 slowQueryPatternsGetList(Postgres 标签,Beta),返回按 digest 归一化查询模式的延迟、IO 与调用统计。两个端点都需要 organizationId 和 serviceId 路径参数,以及用户提供的 API key/secret。

使用方式:按六步流程执行。先按 rules/openapi-discovery.md 从 https://api.clickhouse.cloud/v1 获取 OpenAPI 规范,按 operationId 定位两个操作,解析路径模板、必需查询参数与响应 schema,并建立会话级字段角色映射,后续请求与引用均使用解析出的字段名,不凭记忆硬编码。第二步按 rules/prometheus-scrape.md 抓取一次 Prometheus 系统 gauge(CacheHitRatio、ActiveConnections、MemoryUsedPercent、FilesystemUsedPercent),无需等待;仅在第四步指向写拥塞时才可选做第二次抓取以获取计数器增量。第三步拉取慢查询模式,按 rules/slow-query-patterns-fields.md 解读字段,这是主要诊断依据。第二、三步仅共享认证、无数据依赖,可并行执行。第四步按 rules/triage.md 将信号匹配到全表扫描、热循环(N+1)、写拥塞等启发式形状;无法干净匹配时不要臆造假设,应展示主要模式并询问用户。第五步按 rules/output-template.md 输出症状、证据、假设(含无法排除的替代原因)、短期修复与长期跟进。第六步按 rules/recommend-only.md 只写建议,不执行 DDL,不调用 pg_cancel_backend 或 pg_terminate_backend。

限制:无法获取查询计划/EXPLAIN 输出、按表的扫描类型计数器(seq_scan/idx_scan)、autovacuum 或最近 ANALYZE 时间戳,只能从 IO 与时间信号推理。两个端点均为 Beta,路径、参数与 JSON 字段名可能变化。若慢查询模式没有返回有意义的 totalDurationUs,说明报告可能夸大或问题并非查询形态,应停止并告知用户已检查的内容。完整规则见 AGENTS.md。