Kong网关升级至3.7.0后Prometheus监控指标丢失问题分析

问题背景

在Kong网关从3.6.1版本升级到3.7.0后，部分用户报告在使用Prometheus插件时遇到了监控指标丢失的问题。具体表现为/metrics端点不再显示关键的HTTP请求指标（如kong_http_requests_total和kong_kong_latency*等），仅保留了基础的系统指标。

问题现象

升级后，虽然Prometheus插件配置保持不变（包括带宽指标、延迟指标、消费者级别指标、状态码指标和上游健康指标等），但监控端点仅返回以下四类指标：

• 数据平面集群证书过期时间
• 数据存储可达性状态
• 内存使用情况
• Nginx相关指标

根本原因分析

经过深入排查，发现问题源于Nginx配置模板的变更。在Kong 3.7.0版本中，官方对nginx_kong.lua模板文件进行了重要更新，而使用自定义Nginx模板的用户如果没有同步这些变更，就会导致部分监控功能异常。

具体表现为：

1. 服务能够正常启动，没有明显的错误日志
2. Prometheus插件看似正常工作，但关键指标无法暴露
3. 调试日志中缺乏明确的错误提示

解决方案

对于遇到此问题的用户，建议采取以下步骤：

1. 获取最新版本的nginx_kong.lua模板文件
2. 将变更合并到自定义的Nginx模板中
3. 特别注意与指标收集相关的配置部分
4. 重启Kong服务使变更生效

最佳实践建议

为避免类似问题，建议用户：

1. 在升级Kong版本时，同时检查Nginx模板的变更
2. 建立自定义模板与官方模板的差异管理机制
3. 升级前进行充分的测试环境验证
4. 考虑使用版本控制工具管理配置变更

后续版本验证

根据社区反馈，在Kong 3.9.0版本中，使用相同的Prometheus插件配置可以正常获取所有预期指标。建议受影响的用户考虑升级到最新稳定版本以获得更好的兼容性和性能。

总结

Kong网关的监控功能依赖于正确的Nginx配置，特别是在使用自定义模板时，版本升级过程中的配置同步至关重要。通过正确维护Nginx模板，可以确保Prometheus插件完整暴露所有监控指标，为系统运维提供可靠的数据支持。