OTLP接收器无导出指标：Prometheus接收Spring Boot指标异常求助

我正尝试将OTel指标推送到Prometheus，本地运行prom/prometheus:v3.0.1 Docker镜像，完整Docker配置如下：

prometheus:
  image: prom/prometheus:v3.0.1
  extra_hosts: [ 'host.docker.internal:host-gateway' ]
  volumes:
    - prometheus:/prometheus
    - ./prometheus/:/etc/prometheus/
  command:
    - --web.enable-otlp-receiver
    - --enable-feature=exemplar-storage
    - --web.enable-remote-write-receiver
    - --config.file=/etc/prometheus/prometheus-${profile:-dev}.yml
    - --log.level=debug
  ports:
    - 9090:9090

对应的Prometheus配置文件内容：

storage:
  tsdb:
    out_of_order_time_window: 1m

otlp:
  promote_resource_attributes:
    - service.name
  translation_strategy: NoUTF8EscapingWithSuffixes

同时搭建了Spring Boot 3.4应用，引入以下依赖：

implementation("org.springframework.boot:spring-boot-actuator")
implementation("io.micrometer:micrometer-registry-otlp")

Spring配置属性：

management:
  otlp:
    metrics:
      export:
        step: 15s
        url: ${bytechef.metrics.otlp.endpoint}

应用将指标以OTel格式推送到Prometheus的/api/v1/otlp/v1/metrics端点，经Wireshark确认，应用已成功导出指标至该端点，且收到Prometheus返回的HTTP 200 OK响应，但Prometheus中无任何指标显示，也无错误信息提示原因。想问：是否有人成功配置过Prometheus的OTLP接收器？该功能是否仍在开发中？

1. 功能状态说明 #

Prometheus 3.0.1的OTLP接收器是稳定可用功能，并非处于开发阶段，已有大量生产环境落地案例。

2. 核心排查方向 #

• 深挖Prometheus日志：虽然日志级别设为debug，需重点检索otlp关键字段，查看指标转换、存储环节的细节日志，确认是否存在指标被过滤、转换失败的静默处理情况。
• 验证端点路径完整性：确保Spring Boot配置的url为完整路径，例如http://host.docker.internal:9090/api/v1/otlp/v1/metrics，避免路径拼写遗漏或错误。
• 检查指标命名合规性：OTel指标转Prometheus格式时，若不符合Prometheus命名规则（仅允许字母、数字、下划线、冒号），会被静默丢弃。可开启Spring Boot应用的Micrometer调试日志，查看导出的指标名称是否合规。
• 调整OTLP转换策略：当前配置的NoUTF8EscapingWithSuffixes策略可能导致含特殊字符的指标无法被正确处理，可尝试切换为默认的UTF8Escaping策略后重新测试。
• 确认时间同步状态：Prometheus的out_of_order_time_window: 1m允许一定范围的乱序数据，但如果应用与Prometheus服务器时间偏差过大，指标会被拒绝存储，需确保两者时间同步。

3. 快速验证方法 #

用curl手动发送OTel格式的测试指标到Prometheus端点，验证是否能正常存储：

curl -X POST http://localhost:9090/api/v1/otlp/v1/metrics \
-H "Content-Type: application/json" \
-d '{
  "resourceMetrics": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": {"stringValue": "test-service"}
          }
        ]
      },
      "scopeMetrics": [
        {
          "scope": {"name": "test-scope"},
          "metrics": [
            {
              "name": "test_counter",
              "counter": {
                "dataPoints": [
                  {
                    "asDouble": 1.0,
                    "timeUnixNano": "'$(date +%s%N)'"
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}'

发送完成后在Prometheus查询test_counter，确认是否能检索到指标。

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