Spring Boot集成Micrometer Elasticsearch Registry仅索引空文档问题

我之前也碰到过类似的棘手问题，结合你的场景，咱们一步步排查解决：

1. 优先排查版本兼容性问题 #

Spring Boot 2.1.7默认依赖的Micrometer版本是1.1.x，而这个版本的micrometer-registry-elastic对Elasticsearch 7.x的支持并不完善——早期的Registry实现还在使用ES 6.x的type语法，和ES 7.x的无type（或仅支持_doc）特性冲突，会导致数据看似推送成功，但实际无法正确写入字段。

解决办法：在pom.xml中单独指定兼容ES 7.x的micrometer-registry-elastic版本（比如1.3.10，这个版本完美支持ES7.x，且和Spring Boot 2.1.x兼容）：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-elastic</artifactId>
    <version>1.3.10</version>
</dependency>

2. 手动创建适配ES 7.x的索引模板 #

Micrometer默认自动创建的索引映射在ES 7.x中可能存在字段类型不匹配的问题，导致数据被“隐形”丢弃。你可以提前创建一个索引模板，确保指标字段能正确被解析：

用Kibana或Postman执行以下ES请求：

PUT _template/micrometer-metrics
{
  "index_patterns": ["micrometer-*"],
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas": 0
  },
  "mappings": {
    "_doc": {
      "dynamic_templates": [
        {
          "numeric_metrics": {
            "match_mapping_type": "double",
            "mapping": {
              "type": "scaled_float",
              "scaling_factor": 1000
            }
          }
        }
      ],
      "properties": {
        "@timestamp": {
          "type": "date"
        },
        "name": {
          "type": "keyword"
        },
        "tags": {
          "type": "object"
        },
        "value": {
          "type": "double"
        }
      }
    }
  }
}

这个模板会匹配所有以micrometer-开头的索引，确保时间戳、指标名称、标签和数值字段都能正确存储。

3. 核对Micrometer配置项 #

确保你的application.yml（或application.properties）中配置正确，没有遗漏关键项：

management:
  endpoints:
    web:
      exposure:
        include: metrics,prometheus # 可选，方便验证指标是否生成
  metrics:
    web:
      server:
        auto-time-requests: true # 确保MVC请求指标被采集
    export:
      elastic:
        enabled: true
        host: http://your-es-host:9200 # 替换成你的ES地址
        index: micrometer-demo # 自定义索引名，会自动匹配上面的模板
        step: 1m # 和你日志里的推送频率一致

4. 验证指标是否真的生成 #

在解决推送问题前，先确认应用本身是否生成了指标：

• 访问http://localhost:8080/actuator/metrics，查看是否有jvm.*、http.server.requests等指标；
• 如果没有，检查是否有自定义的MeterFilter不小心过滤了所有指标——比如如果你的启动类里有类似下面的代码，要确保规则正确：

@Bean
public MeterFilter meterFilter() {
    // 示例：只保留jvm和http开头的指标，不要写反规则
    return MeterFilter.denyUnless(name -> name.startsWith("jvm") || name.startsWith("http"));
}

5. 检查ES的隐性日志 #

即使Bulk请求返回errors: false，ES也可能在日志中记录警告（比如字段类型不匹配）。去ES的安装目录下查看logs/elasticsearch.log，搜索warn或micrometer相关的日志，能帮你找到隐藏的问题。

按照上面的步骤操作后，重新启动应用并调用/test接口，应该就能在ES中看到包含JVM指标、请求耗时等有效数据的文档了。

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