Prometheus配置metrics_path带?参数被转义为%3F返回404求解决方案

问题根因 #

Prometheus的metrics_path字段仅用于定义请求的URL路径部分，不支持直接拼接查询参数。你将/?output=text写入该字段时，Prometheus会将?识别为路径的普通字符进行URL编码，转义为%3F，最终请求路径不符合预期导致404报错。

解决方案 #

你提到params字段需要标准键值结构无法匹配需求，实际上output=text就是典型的单键单值标准参数结构，之前配置失败大概率是不了解params字段的取值规则：参数值必须用数组格式包裹。正确配置样例如下：

- job_name: test-1
  metrics_path: /
  scheme: http
  params:
    output: ["text"]
  static_configs:
  - targets:
    - example.com:1234

该配置下Prometheus会自动将params中的键值对拼接为合法查询参数，最终请求的完整URL就是你需要的http://example.com:1234/?output=text，不会出现特殊字符转义问题。

配置验证 #

配置更新重载完成后，打开Prometheus控制台，进入「Status」-「Targets」页面，找到该job对应的采集目标，点击端点链接即可直接验证生成的URL是否符合预期。

内容的提问来源于stack exchange，提问作者Roberta Soliman