SuperAPI AI 工具集

troubleshoot-cassandra

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:该技能封装 Netdata 的 Apache Cassandra 运维手册,用于在 Cassandra 出现错误升高、延迟、饱和、资源耗尽或意外重启时,为编码智能体提供结构化分诊路径。它不替代手册,而是通过 MCP 查询手册所依赖的同一批信号。

主要能力:将 Cassandra 健康拆分为可用性、吞吐、延迟、错误、饱和/内部状态、复制/一致性等 8 个信号域,每个域对应一个规则文件。重点覆盖五类故障原型:GC 死亡螺旋、压缩死亡螺旋、墓碑风暴、磁盘空间耗尽、提示溢出。Netdata 的 cassandra 采集器在 cassandra.* 下输出 28 个 context。

使用方式:先通过 MCP 的 list_nodes 确认目标主机上的服务在线;用 query_metrics 拉取最近 15 分钟信号,并并行运行 find_anomalous_metrics 定位异常;按五类原型逐一检查,结合主机级信号(system.cpu.utilization、system.memory.usage、system.disk.io_time)关联;应用规则文件或手册中的修复建议后,重跑验证查询确认信号回归正常。常用调用模板包括 list_metrics q="cassandra"、query_metrics context="cassandra.dropped_messages_rate" relative_window=-15m、find_anomalous_metrics node=<host> context_pattern="cassandra.*"、find_correlated_metrics、list_raised_alerts。

验证:对 cassandra.dropped_messages_rate、cassandra.client_requests_timeouts_rate、cassandra.client_requests_failures_rate、cassandra.client_requests_rate、cassandra.client_requests_latency、cassandra.row_cache_hit_rate 等 context 查询 30 分钟窗口;修复后 10 分钟重跑应显示干净结果,否则回退深查。

限制:依赖 Netdata 实例与 MCP 集成;不替代运维手册;若修复后 30 分钟内信号回漂,说明根因更深,需将查询窗口扩大到 2-6 小时。具体阈值需按实际负载调优。