用途:面向 ByteHouse 集群的运维排障,提供健康检查、慢查询分析、查询优化建议、负载与计算组资源使用(CPU、内存、并发等)分析、吞吐量分析与性能瓶颈定位。
主要能力:Skill 本身不直连集群、不执行 SQL、不做本地分析,全部诊断能力经由 scripts/diagnostics.py 转发到 ByteHouse Matrix Agent(ByteHouse 官方维护的诊断专用 Agent),并以流式响应返回结果。
使用方式:前置条件为 Python 3.8+、requests(未安装时 pip install requests 或 python3 -m pip install requests)、jq(用于解析 JSON 配置)、有效的集群连接信息存于 ~/.bytehouse_config.json,需包含 BYTEHOUSE_HOST 与 BYTEHOUSE_PASSWORD。加载配置后执行诊断: source scripts/export_config.sh python3 scripts/diagnostics.py "你的诊断问题" 提问建议明确时间窗口、点名库表或计算组、一次只问一个主题,中文即可,并可要求给出优化建议。
适用场景:节点存活、副本延迟、异常任务与错误日志等整体健康检查;慢查询 TOP 识别与优化;计算组负载与排队情况分析;QPS、失败率、平均响应时间等吞吐量分析;热点表与告警根因排查。
限制:密码只写入配置文件,不要在会话、日志或额外脚本中回显;若脚本返回连接错误、超时或 401/403,应按失败兜底处理,严禁绕过脚本自行连接集群或执行 SQL;所有分析与建议须来自 Matrix Agent 返回结果。具体收费标准、服务价格与配额信息暂未提供。