如何配置Prometheus通过POST请求抓取数据源指标

核心结论 #

原生Prometheus没有原生支持你描述的「发送POST请求、在请求体中携带API Key和User ID参数抓取指标」的能力，不存在完全不部署额外软件就能适配你当前数据源要求的实现方案。

原生Prometheus的抓取能力边界 #

默认情况下Prometheus的指标抓取逻辑有明确限制：

• 仅支持向目标端点发送GET请求发起抓取，无法配置修改请求方法为POST
• 支持的自定义参数传递方式只有两类：
  • 通过自定义请求头传递参数，支持Bearer Token、Basic Auth、任意自定义Header字段
  • 通过URL查询参数传递，可在抓取配置中声明参数自动拼接在目标URL后
• 完全没有提供配置POST请求体内容的相关选项，无法直接向请求体中写入自定义参数。

零额外部署的可行折中方案 #

如果你的数据源支持调整参数接收规则，不需要强制把参数放在POST请求体中，就可以直接通过原生Prometheus配置完成抓取，不需要部署任何额外组件：

• 方案1：让数据源支持从请求头读取API Key和User ID
  对应Prometheus抓取配置参考：

  scrape_configs:
    - job_name: "custom_datasource"
      static_configs:
        - targets: ["<你的数据源地址>:<端口>"]
      headers:
        X-API-Key: "<你的实际API Key>"
        X-User-ID: "<你的实际User ID>"
  

• 方案2：让数据源支持从URL查询参数读取API Key和User ID
  对应Prometheus抓取配置参考：

  scrape_configs:
    - job_name: "custom_datasource"
      static_configs:
        - targets: ["<你的数据源地址>:<端口>"]
      params:
        api_key: ["<你的实际API Key>"]
        user_id: ["<你的实际User ID>"]
  

如果你的数据源严格限定必须使用POST请求、且两个参数必须放在请求体中，没有任何兼容调整的空间，就必须部署额外中转组件实现：比如部署轻量的自定义exporter，接收Prometheus发来的GET抓取请求，内部转换为符合数据源要求的带请求体的POST请求拉取数据，转换为Prometheus兼容的指标格式后返回即可，这类中转组件逻辑非常简单，资源开销极低。

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