SuperAPI AI 工具集

suzieq-observability

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:通过 SuzieQ 网络可观测性服务查询当前及历史网络状态,运行验证断言,获取摘要统计,追踪转发路径。服务脚本为 mcp-servers/suzieq-mcp/server.py,传输方式为 stdio(JSON-RPC 2.0),环境变量包括 SUZIEQ_API_URL、SUZIEQ_API_KEY,可选 SUZIEQ_VERIFY_SSL(默认 true)与 SUZIEQ_TIMEOUT(默认 30s)。

主要能力(共 5 个工具):suzieq_show 查询任意 SuzieQ 表的详细网络状态,支持 namespace、hostname、columns、start_time、end_time、view(latest/all/changes)及 filters(key=value 以 & 分隔);suzieq_summarize 获取表的聚合统计与摘要;suzieq_assert 对表运行验证断言(仅限 bgp、ospf、interface、evpnVni);suzieq_unique 获取某列的去重值与计数;suzieq_path 追踪两个端点之间的转发路径(需 namespace、source、destination,可选 vrf,默认 default)。

使用方式:先以 suzieq_show 或 suzieq_summarize 了解当前状态,再用 suzieq_assert 验证健康,用 suzieq_unique 探索列值分布,用 suzieq_path 追踪转发路径,并在 show/summarize 上使用 start_time/end_time 进行历史分析。支持的表包括 address、arpnd、bgp、device、devconfig、evpnVni、fs、ifCounters、interface、inventory、lldp、mac、mlag、namespace、network、ospf、route、sqPoller、topology、vlan。

适用场景:网络状态查询、设备排查、时间旅行式历史分析、高层概览与容量规划、变更前后验证与合规检查、连通性排障与路径分析。

限制:断言工具仅支持 bgp、ospf、interface、evpnVni 四张表;需要配置 SuzieQ API 地址与密钥;其他价格、平台与效果信息暂未提供。