witty-diagnosis-agent网络故障诊断：从物理层到应用层的完整排查流程

witty-diagnosis-agent网络故障诊断：从物理层到应用层的完整排查流程

【免费下载链接】witty-diagnosis-agentThe witty-diagnosis-agent is an intelligent diagnostic tool that provides automated analysis and troubleshooting for complex system issues.项目地址: https://gitcode.com/openeuler/witty-diagnosis-agent

前往项目官网免费下载：https://ar.openeuler.org/ar/

witty-diagnosis-agent是一款智能诊断工具，专为复杂系统问题提供自动化分析和故障排除功能。其内置的network-diagnosis技能采用快照先行、分层收敛、证据驱动的系统化诊断方法论，帮助用户从物理层到应用层全面排查网络故障。

网络故障诊断的痛点与挑战

网络故障诊断是运维领域最复杂、最令人头疼的任务之一——链路层、网络层、传输层、应用层层层交织，ARP表满、MTU不匹配、防火墙规则误配、路由黑洞、IP冲突……任何一个环节出问题，表象可能都是"不通"这两个字。传统排查依赖工程师从ping开始逐层手动探测，过程冗长且容易遗漏关键线索。

传统排查模式存在三个系统性缺陷：

• 信息不全：人工操作逐个命令执行，容易出现重复劳动或遗漏关键检查项（如conntrack使用率、ARP gc_thresh配置）。
• 因果混淆：单一异常可能被多个证据推翻。例如"ping不通"可能是防火墙DROP了ICMP，也可能路由不存在，这两者的修复思路完全不同。
• 经验依赖：资深工程师凭直觉就能快速定位，但新手容易在错误分支上越走越远。

witty-diagnosis-agent网络诊断的核心架构

witty-diagnosis-agent的网络诊断功能基于分层流水线架构设计，通过多个Agent协同工作，实现从数据采集到根因定位的全流程自动化。

智能诊断Agent包含故障诊断Agent和故障修复Agent两大核心模块，其中故障诊断Agent负责诊断规划、编排调度、验证分析和根因融合，而网络故障诊断是其重要技能之一。

四步穿透式排查方法论

network-diagnosis技能采用四步穿透式排查方法论，通过严格的流程控制和证据验证，确保诊断结果的准确性和可靠性。

第一步：快照采集

Agent调用collect_snapshot.sh脚本，一次性获取18类网络状态数据，包括接口状态、路由表、ARP表、防火墙规则等关键信息。采集过程中严格遵循时间窗口过滤原则，确保只收集故障时间段内的数据。

# Agent执行的命令示例 bash scripts/collect_snapshot.sh \ --out /tmp/net_diag \ --since "2026-03-23 10:00" \ --until "2026-03-23 10:30" \ --dest 8.8.8.8

同时，Agent会单独执行IP冲突检测，通过arping命令发送探测包，确认是否存在IP地址冲突问题。

第二步：综合分析

在完成所有快照数据采集后，Agent开始综合分析阶段。这一阶段采用"先读完全文、再开始推理"的策略，避免过早锚定结论。Agent会读取所有18个快照文件，提取异常信号，并进行多源交叉验证。

例如，对于ARP表满的判断，Agent需要同时验证三个条件：

• ARP使用率超过90%
• 接口存在异常丢包
• 内核日志中有邻居表溢出告警

只有三者同时成立，才能判定ARP表满是丢包的根本原因。

第三步：分支收敛

根据综合分析阶段识别出的异常信号，Agent选择最可能的分支深入排查。主要分支包括：

• L1-L2物理/ARP分支：处理接口丢包、ARP异常等问题
• L3路由分支：处理路由不可达、策略路由问题
• DNS分支：处理域名解析失败问题
• L4防火墙/conntrack分支：处理端口不通、连接跟踪表溢出问题
• MTU/性能分支：处理大包不通、网络性能问题

Agent采用"节俭探针"策略，每个分支只执行少量高价值检查，快速验证或排除假设。

第四步：根因定位

在确定故障分支后，Agent深入验证当前假设，重建因果与时间链，最终生成标准化故障报告。报告包含故障时间窗口、影响范围、根因分析和修复建议等关键信息。

修复建议按风险等级分为高危、中危和低危，高危操作必须提供回滚方案，确保安全操作。

实际诊断案例分析

场景：服务器eth0接口间歇性断网

诊断流程：

1. 确定时间窗口：根据用户描述"刚才"，设置故障时间窗口为最近30分钟
2. 场景识别：指定接口eth0，进入场景A（聚焦模式）
3. 采集快照：执行collect_snapshot.sh和ip_conflict_check.sh
4. 综合分析：发现ARP表使用率195%，eth0接口RX dropped异常，内核日志有ARP表溢出记录
5. 交叉验证：确认ARP表满是丢包根本原因
6. 分支收敛：进入L1-L2分支，发现gc_thresh3配置过低
7. 生成报告：提出临时增大ARP表上限的修复建议

关键命令：

# 临时增大ARP表上限 sysctl -w net.ipv4.neigh.default.gc_thresh3=2048 # 回滚命令 sysctl -w net.ipv4.neigh.default.gc_thresh3=1024

网络诊断技能的核心优势

witty-diagnosis-agent的network-diagnosis技能具有以下核心优势：

• 证据驱动：基于18类快照数据，不依赖猜测或直觉
• 流程固化：四步流水线+强制检查点，确保诊断质量
• 认知防偏：禁止边采边分析、强制交叉验证，避免确认偏误
• 安全内置："只诊断不修复"原则，确保操作安全

如何开始使用witty-diagnosis-agent进行网络诊断

要开始使用witty-diagnosis-agent进行网络故障诊断，首先需要克隆项目仓库：

git clone https://gitcode.com/openeuler/witty-diagnosis-agent

详细的使用方法请参考官方文档：docs/guide/MANUAL.md

网络诊断相关的技能实现位于：skills/network-diagnosis/

总结

witty-diagnosis-agent的网络故障诊断功能为用户提供了从物理层到应用层的完整排查流程。通过快照先行、分层收敛、证据驱动的系统化诊断方法论，能够快速定位网络故障根因，大幅提高运维效率。无论是新手还是资深工程师，都能通过这款工具获得专业的网络诊断支持，让网络故障排查变得简单而高效。

【免费下载链接】witty-diagnosis-agentThe witty-diagnosis-agent is an intelligent diagnostic tool that provides automated analysis and troubleshooting for complex system issues.项目地址: https://gitcode.com/openeuler/witty-diagnosis-agent