用途:面向网络设备的系统性故障排查,覆盖连通性中断、路由协议邻居异常、接口抖动与性能/高延迟等问题,采用定义问题、收集事实、列可能原因、制定计划、逐一验证、记录归档的流程,并结合 OSI 分层与分治法定位。
主要能力:通过 pyATS 相关 MCP 工具在设备上执行只读 show 命令与 ping,例如 pyats_run_show_command、pyats_ping_from_network_device、pyats_show_logging,以及 pyats_list_devices。可按层排查:L1 看接口 up/up 与 CRC、输入错误;L2 看 ARP、MAC 表、VLAN、STP;L3 看接口 IP、路由表、逐跳 ping、指定源与包大小测试 MTU;L4+ 查 ACL 命中计数与 NAT 转换。协议侧给出 OSPF 邻居(hello/dead 定时器、区域、认证、网络类型、MTU、passive、ACL)与 BGP 邻居(TCP 179、update-source、ebgp-multihop、AS、MD5、address-family、NOTIFICATION 错误码)检查清单。性能排查涉及 CPU/内存、接口利用率与丢包、QoS policy、路径与路由环路。
使用方式:需设置 PYATS_TESTBED_PATH、PYATS_MCP_SCRIPT 等环境变量,命令形如 PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_show_command '{"device_name":"R1","command":"show interfaces"}'。多跳场景可用并行状态采集,一次在所有可疑跳点执行相同命令,并按严重程度排序;邻居问题需同时检查两端。若配置了 NETBOX_MCP_SCRIPT,可用 netbox_get_objects 核对接口、线缆、IP 预期状态,发现 IP 漂移或拓扑变化;排查后可用 GAIT_MCP_SCRIPT 的 gait_record_turn 记录结论与处置。
适用场景:企业或实验网络的路由交换设备排障、协议邻居诊断、性能与接口抖动分析。
限制:资料未提供具体版本要求、依赖安装步骤、支持的厂商与平台范围、费用与授权信息;工具调用失败(认证或连接错误)应先检查上述环境变量,遇到超时、不可达或响应异常应直接上报错误,不得编造结果;涉及改变状态的操作需遵守审批与变更门禁;GAIT 示例仅为示意,须替换为实际观测证据。