SuperAPI AI 工具集

konnect-event-gateway

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能用于诊断 Konnect Event Gateway 的请求流,覆盖监听器、主机名映射、虚拟/后端集群、认证与策略评估等环节。它强调按 Event Gateway 自身的实体模型排查,而非套用标准网关假设。

主要能力:默认沿请求路径端到端追踪:client -> listener -> virtual cluster -> backend cluster -> policy and auth,定位失败的 Event Gateway 跳点。提供检查顺序:识别失败事件路径、确认控制平面与对象存在、验证监听器可达性与映射、检查集群路由意图、单独评估认证与策略、返回单一失败域并附证据。

使用方式:优先使用共享的 kong-konnect MCP 服务器做实时检查;只读资源检查可用 kongctl-query;需要变更 Event Gateway 资源时,保留仓库既定的声明式工具链,kongctl YAML 用 kongctl-declarative,HCL 管理的资源用 terraform-konnect。按分支加载对应参考文件:event-path-map.md、listener-and-hostname-mapping.md、cluster-routing-boundaries.md、auth-and-policy-order.md。

适用场景:客户端连接被拒、重写或失败;监听器可达性、主机名映射、TLS 或协议假设问题;虚拟集群到后端集群路由意图不清;认证与策略评估顺序问题。

限制与交接:若阻塞点是通用控制平面、数据平面或发布健康问题,应尽早交给 konnect-gateway-triage;涉及资源查看或管理权限时用 konnect-access-scope;需要声明式修复时用 kongctl-declarative 或 terraform-konnect。若实时 Konnect 状态重要但 kong-konnect MCP 未连接,应尽早说明并改用 CLI 或用户提供的工件。成功连接监听器不代表策略通过,主机名与监听器不匹配可能表现为认证失败,虚拟集群与后端集群混淆可能产生看似正确的监听器但下游路由错误。