如何修改OpenTelemetry Collector中Prometheus exporter的默认路径？

OpenTelemetry Collector官方的Prometheus exporter确实没有提供直接配置暴露路径的参数，它默认固定使用/metrics作为指标端点。不过有两种可行的解决方案：

方案1：使用Contrib版Collector的http_handler扩展（纯Collector配置） #

这个方法需要使用OpenTelemetry Collector的contrib版本（包含更多扩展组件），通过http_handler扩展创建自定义路径的端点，将请求转发到原生的/metrics路径。

修改后的完整配置如下：

receivers:
  otlp:
    protocols:
      grpc: 
        endpoint: "0.0.0.0:4317"

exporters:
  prometheus:
    endpoint: "127.0.0.1:10000"  # 改为仅监听本地，避免原生/metrics被外部直接访问

extensions:
  http_handler:
    endpoint: "0.0.0.0:10001"  # 对外暴露的端口
    paths:
      /v1/metrics:
        method: GET
        handler: proxy
        proxy:
          url: "http://127.0.0.1:10000/metrics"

service:
  extensions: [http_handler]  # 启用该扩展
  pipelines:
    metrics:
      receivers: [otlp]
      exporters: [prometheus]

配置说明 #

1. 将Prometheus exporter的监听地址改为127.0.0.1:10000，只允许本地访问，防止原生的/metrics路径被外部直接访问
2. 通过http_handler扩展在0.0.0.0:10001端口对外暴露/v1/metrics路径，所有对该路径的GET请求都会被代理到原生的http://127.0.0.1:10000/metrics
3. 后续Prometheus只需抓取http://<collector-ip>:10001/v1/metrics即可

方案2：用反向代理（如Nginx）做路径映射 #

如果不想使用contrib版Collector，可以借助反向代理工具实现路径重写。以Nginx为例，配置示例如下：

server {
    listen 10000;
    server_name your-collector-host;

    location /v1/metrics {
        proxy_pass http://127.0.0.1:9090/metrics;  # 替换为Collector Prometheus exporter原本的监听端口
        proxy_set_header Host $host;
    }
}

配置说明 #

1. Nginx监听你希望对外提供服务的端口（比如10000）
2. 当外部请求/v1/metrics时，Nginx会自动转发到Collector原生的/metrics路径
3. Collector的Prometheus exporter保持原有配置endpoint: "127.0.0.1:9090"即可，避免直接对外暴露原生端点

为什么你之前的尝试失败 #

exporters.prometheus.endpoint字段仅用于配置监听的IP和端口，不支持添加路径后缀。直接在里面拼接/v1/metrics会被解析为端口的一部分，因此触发了unknown port的错误。

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