用途:面向 ClickHouse 事故的逐步响应手册,按严重级别(P1 至 P4)对故障分级,使用内置系统表与 SQL 命令完成快速分诊、诊断和恢复。
主要能力:提供快速分诊命令(如 curl 检查 8123 端口存活、查询 system.processes、system.metrics、system.merges、system.query_log 等);给出决策树按“服务器是否响应、查询是否成功、是否变慢”分类故障;覆盖 P1 服务器宕机/OOM、磁盘满,P2 卡住查询、分区过多、内存压力,P3 复制延迟等场景的修复流程;支持收集证据并导出事故窗口数据用于复盘。
使用方式:先运行快速分诊,再按决策树分类,然后跳转到对应修复流程。示例命令包括 KILL QUERY WHERE query_id = 'abc-123-def'; 和 ALTER TABLE analytics.events DROP PARTITION '202301';。完整多步流程见 references/remediation-procedures.md,证据导出与沟通模板见 references/evidence-and-comms.md。
前提条件:可访问 ClickHouse HTTP 接口(默认端口 8123)或可用的 clickhouse-client;具备读取 system.* 表及执行 KILL QUERY / ALTER 权限的用户;P1 重启需主机或容器 shell 访问(systemctl、docker 或 kubectl)。
适用场景:ClickHouse 服务器不可达、查询失败、性能下降、插入失败、磁盘告警、复制延迟等事故处理。
限制:若服务器对 ping 完全无响应,不应继续执行 SQL,应直接进行 P1 主机级检查(进程、磁盘、OOM 日志)。具体收费、价格、平台支持等信息暂未提供。