kong-gateway-analyzer

name	kong-gateway-analyzer
description	Kong 网关日志查询分析技能。 触发场景： - 查看 Kong 访问日志、排查 API 错误/超时 - 分析域名/路由/服务的流量和错误 - 分析请求延迟和性能瓶颈 反馈机制: 支持用户纠正和补充，持续改进

Kong Gateway Analyzer

Kong 网关日志查询分析技能。脚本获取数据，Agent 负责分析。

---

核心脚本

query_kong_logs.sh - 通用日志查询

# 查询域名日志
scripts/query_kong_logs.sh -c prod-cluster -H api.example.com -l 100

# 查询 5xx 错误
scripts/query_kong_logs.sh -c prod-cluster --status 5xx -t 1h

# 查询慢请求并统计
scripts/query_kong_logs.sh -c prod-cluster --slow 1000 -t 15m --analyze

关键参数：

参数	说明	默认
-c	集群名称 (必需)	-
-H	域名过滤	-
-t	时间范围 (5m/1h/24h)	5m
--status	状态码 (200/4xx/5xx)	-
--slow	慢请求阈值(ms)	-
--analyze	统计分析模式	false

analyze_traffic.sh - 流量分析

# 分析域名流量
scripts/analyze_traffic.sh -c prod-cluster -H api.example.com -t 10m

返回：QPS、状态码分布、延迟统计(p50/p95/p99)、Top URI、慢请求

diagnose_5xx_errors.sh - 5xx 错误诊断

scripts/diagnose_5xx_errors.sh -c prod-cluster -t 10m
scripts/diagnose_5xx_errors.sh -c prod-cluster -H api.example.com -t 1h

返回：错误总数、状态码分类、按上游/URI/域名分组、时间分布、样本

diagnose_slow_requests.sh - 慢请求诊断

scripts/diagnose_slow_requests.sh -c prod-cluster --slow 1000 -t 10m
scripts/diagnose_slow_requests.sh -c prod-cluster -H api.example.com --slow 500

返回：慢请求数量占比、延迟分布、按上游/URI 分组、Top 20 慢请求、延迟来源分析

---

关键阈值

指标	正常	警告	严重
总响应时间	<500ms	500ms-2s	>2s
上游响应时间	<200ms	200ms-1s	>1s
Kong 处理延迟	<10ms	10ms-50ms	>50ms
5xx 错误率	<0.1%	0.1%-1%	>1%

---

故障排查

5xx 错误排查

1. 诊断错误分布
   scripts/diagnose_5xx_errors.sh -c prod-cluster -t 1h

2. 根据状态码分支
   ├─ 502 → 检查上游服务状态
   ├─ 504 → 使用慢请求诊断
   └─ 500 → 检查上游服务日志

延迟问题排查

1. 诊断慢请求
   scripts/diagnose_slow_requests.sh -c prod-cluster --slow 1000

2. 分析延迟来源
   ├─ upstream_caused_percent > 70% → 优化上游服务
   └─ kong_time 占比高 → 检查 Kong 资源/插件

---

环境配置

VictoriaLogs API: https://victorialogs.example.com

集群标签：

名称	标签
生产	prod-cluster
计算	compute-cluster
腾讯云	tencent-cluster
阿里云	aliyun-cluster

---

反馈与改进

支持持续改进。发现问题请直接告知：

类型	示例
纠正	"状态码字段应该是 status"
补充	"缺少 SSL 握手失败的错误模式"
优化	"排查流程需要补充..."