SuperAPI AI 工具集

hydra-head-troubleshooter

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:面向 Cardano Hydra Head 的运维排障,按症状定位根因并给出修复与验证步骤。适用症状包括:Head 不启动或日志中观察不到 Head;Head 存在但不推进;对等节点不同步或断连;日志出现 PeerConnected、AckSn、LogicOutcome 等错误。

主要能力:提供决策树,分为“链上观察不到 Head”“Head 不推进”“节点不同步”“镜像节点/高可用问题”四类,并给出对应检查项与修复方向;提供日志关键字含义表(PeerConnected、PeerDisconnected、AckSn、LogicOutcome、SnapshotConfirmed、HeadIsOpen、HeadIsClosed)与修复后验证清单。

使用方式:先确认网络与 hydra-node 版本,向所有参与方索取同一时间窗口的日志,不索取密钥内容(文件路径可以)。常用诊断命令包括 hydra-node --version、curl -s localhost:4001/health、curl -s localhost:4001/peers、curl -s localhost:4001/status、curl -s localhost:6001/metrics | grep hydra。若本地未安装 hydra-node,可用技能目录内包装脚本在 Docker 中运行:chmod +x {baseDir}/scripts/hydra-node.sh、{baseDir}/scripts/hydra-node.sh --help、{baseDir}/scripts/hydra-node.sh gen-hydra-key --output-file hydra;多节点 Head 演示建议使用 hydra.family Docker Compose 演示。

限制:输出固定为根因、修复步骤、验证三部分;镜像节点场景下 SnapshotAlreadySigned 属瞬时可忽略告警,镜像数量应小于 floor(n/2) 以保持 quorum 稳定。资料未提供具体版本兼容矩阵、收费与平台支持信息。