Docker环境下启用Kong API Gateway Prometheus插件报错求助

错误原因 #

你使用的kong:2.1.1版本中，Prometheus插件并不支持bandwidth_metrics、latency_metrics、status_code_metrics这三个配置字段——这些字段是在Kong 3.x及以后版本才新增的配置项，旧版本解析时无法识别，因此抛出"unknown field"错误。

解决方案 #

有两种可行的解决方式：

1. 升级Kong版本

如果业务允许升级，将Docker镜像替换为Kong 3.x及以上的稳定版本（比如kong:3.5.0），升级后你的原有YAML配置可以直接使用，无需修改。

2. 使用兼容旧版本的配置

如果无法升级，Kong 2.1.1的Prometheus插件默认就会采集带宽、延迟、状态码相关指标，不需要手动配置这些字段。你可以把配置简化为：

- name: prometheus
    config: {}

或者直接省略config块，因为插件默认配置已经包含了你需要的这些指标采集逻辑。如果需要调整其他2.1.1版本支持的配置项（比如per_consumer），仅保留对应版本文档中列出的字段即可。

内容的提问来源于stack exchange，提问作者Madura Dissanayake