用途:这是 infrahub-collecting-diagnostics 的后续步骤,用于分析已采集好的诊断 bundle,把原始日志转成排查报告,而不是实施修复。
主要能力:解析 bundle_information.json;扫描各服务日志中的错误信号(Python traceback、ERROR/CRITICAL 行、panic、OOM kill、连接失败);将所有 *.previous.log 视为重启证据并读取其尾部;按时间戳与因果链把信号归并为事件,区分根因与级联错误;如 bundle 含 benchmark,则结合 CPU 得分与 Neo4j/PostgreSQL 卷 IOPS 判断性能问题;对每个有 traceback 或特征错误信息的事件,用稳定关键字检索现有 GitHub issue。
使用方式:先向用户询问 bundle 位置,不扫描文件系统、不假设默认目录(默认 ./infrahub_bundles/ 仅可作为提示)。确认其为含 bundle/ 与 bundle_information.json 的 infrahub-collect bundle;若不存在则交由 infrahub-collecting-diagnostics 采集。先读 manifest,再确定部署上下文(版本、Compose 或 Kubernetes 拓扑、副本数)。随后扫描 bundle/logs/ 下每个服务目录,按 reference.md 中的 grep 模式查找信号。检索时使用:gh search issues --repo opsmill/infrahub "<stable keywords>",搜索键基于异常类、归一化消息、最内层 Infrahub 帧,剥离变量 ID、分支名与主机名;不要传 --state。报告按事件分节,含严重级别、证据(bundle 文件路径与引用摘录)、关联推理与匹配的 issue;所有结论必须可追溯到引用行,未知项应标为未知,并建议下一步但不执行。
适用场景:用户说已采集 bundle 想知道问题所在、要分析 Infrahub 日志、询问 traceback 含义、判断崩溃是否为已知问题、排查 task-worker 反复重启时。
限制:严格只读,不接触运行中的 Infrahub 实例,不重启、不改配置、不执行 docker/kubectl 变更;无 bundle 时不自行采集;用户要提交 bug 或功能请求时交由 infrahub-reporting-issues;不运行 gh issue create;不凭猜测定位 bundle 位置;不以易变 token 检索 GitHub;bundle 不完整时交回采集技能,不手工重新采集。