用途:对 Cisco ACI fabric 执行全面健康审计,覆盖节点状态、租户/VRF/BD/EPG 策略、Contract 分析、故障分级与端点学习校验,适用于定期巡检、变更前基线、变更后验证、事件响应、合规审计与容量规划。
主要能力按阶段:阶段1检查 fabric 节点(ID、角色、序列号、状态、固件、型号、TEP)、pods 与链路;阶段2遍历租户、VRF、BD、应用配置与 EPG;阶段3审计 Contract 及其 subject/filter;阶段4抓取故障并按 critical/major/minor/warning 分级、读取健康分;阶段5校验端点学习(重复 MAC、端点漂移等)。每阶段含显式判定阈值与 CRITICAL/WARNING 标记。
使用方式:所有 ACI 工具调用通过 mcp-call,前缀环境变量,例如: APIC_URL=$APIC_URL USERNAME=$ACI_USERNAME PASSWORD=$ACI_PASSWORD python3 $MCP_CALL "python3 -u $ACI_MCP_SCRIPT" fabric_nodes '{}' 其他工具名依次为 fabric_pods、fabric_links、tenants_get、fvCtx_get、fvBD_get、fvAp_get、fvAEPg_get、contracts_get、faults、health。须按阶段1至5顺序执行。审计完成后可写入 GAIT(gait_record_turn)留痕,并可选生成 markmap 租户层级图或 Draw.io 拓扑图。
输出:分级文本报告、关键发现与建议,按 CRITICAL > HIGH > WARNING > HEALTHY 取最差状态为总体结论。
限制:示例结果为演示,须替换为实际观测;工具报错(超时、不可达、响应异常)应如实报告,不得编造结果;状态变更类调用超时不能视为失败,需先核查当前状态并保留审批门;示例中的具体数值、租户与 Contract 名称仅为示意,实际使用需替换。