Prometheus配置scrape_config时params URL参数顺序错乱如何解决

Prometheus 处理 scrape_config 中的 params 配置时，不会保留YAML文件里的字段书写顺序，内部会对所有参数名按字典序排序后再拼接成查询串。你遇到的apitoken排在endpoint前面的结果，正好是两个参数名按字典序排序的正常输出，所以不管怎么调换两个字段在配置里的书写位置，都不会改变最终的参数顺序。

补充：HTTP 协议本身没有对查询参数的传递顺序做强制要求，服务端严格依赖参数顺序解析请求属于不符合规范的实现，有条件的话优先修复服务端解析逻辑，从根源规避这类兼容问题。

不要通过params字段传递这两个顺序敏感的参数，直接把按目标顺序拼接好的查询串写入metrics_path即可，Prometheus 会原样使用metrics_path的内容构造请求URL，不会对路径中已存在的查询参数做重排。

固定参数场景 #

如果endpoint和apitoken都是固定值，直接把完整路径+查询串写在metrics_path配置项即可，示例配置：

- job_name: "job1"
  metrics_path: "/metrics/exporter?endpoint=<IP>&apitoken=<API Token>"
  static_configs:
    - targets: ['<你的exporter服务地址>']

如果参数值包含特殊字符，提前做好URL编码即可。

动态参数场景 #

如果参数值需要根据target动态生成（比如不同target对应不同endpoint值），通过relabel_configs在抓取阶段按你需要的顺序拼接查询串，写入__metrics_path__元标签即可，示例配置：

- job_name: "job1"
  static_configs:
    - targets: ['192.168.1.10:9100', '192.168.1.11:9100']
      labels:
        apitoken: "your-api-token-value"
  relabel_configs:
    - source_labels: [__address__, apitoken]
      target_label: __metrics_path__
      replacement: "/metrics/exporter?endpoint=${1}&apitoken=${2}"

以上两种配置生成的请求URL都会严格保留你指定的参数顺序，不会出现自动重排的问题。

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