Zipkin 2.11.7与Elasticsearch 7.x集成报错技术求助

我来帮你拆解这两个报错的根源，以及对应的解决办法：

一、连接Elasticsearch 7.12.1/7.14.1时的冒号索引模板错误 #

问题根源 #

Elasticsearch 7.10+之后的版本对索引模板的index_pattern做了更严格的校验，不允许包含冒号（:）字符。而Zipkin 2.11.7默认使用的索引模板前缀是zipkin:span-，刚好触发了这个限制，导致模板创建失败，进而无法加载服务名称。

解决步骤 #

• 修改Zipkin的存储配置，将索引前缀改为不带冒号的格式：
  • 如果是通过环境变量启动Zipkin，添加参数：

    STORAGE_ES_INDEX_PREFIX=zipkin
    

  • 如果是使用配置文件，找到对应项设置为：

    storage.es.index-prefix=zipkin
    

  这样Zipkin会生成zipkin-span-*格式的索引模式，避开冒号的限制。

二、连接Elasticsearch 7.0.0/7.7.1时的index.mapper.dynamic参数错误 #

问题根源 #

Elasticsearch 6.0版本之后就移除了index.mapper.dynamic这个全局设置，但Zipkin 2.11.7的默认索引模板里依然在使用这个已废弃的参数，导致ES返回参数非法的错误。

解决办法（二选一） #

方案1：手动创建适配ES 7.x的索引模板

1. 先禁用Zipkin自动管理索引模板的功能，避免冲突：
   • 环境变量方式：

     STORAGE_ES_TEMPLATE_MANAGEMENT_ENABLED=false
     

   • 配置文件方式：

     storage.es.template-management-enabled=false
     

2. 编写符合ES 7.x规范的索引模板（示例如下），注意移除index.mapper.dynamic，改用mappings层级的dynamic字段：

   {
     "index_patterns": ["zipkin-span-*"],
     "settings": {
       "number_of_shards": 5,
       "number_of_replicas": 1
     },
     "mappings": {
       "dynamic": false,
       "properties": {
         "traceId": {"type": "keyword"},
         "id": {"type": "keyword"},
         "name": {"type": "keyword"},
         "timestamp": {"type": "date"},
         "duration": {"type": "long"},
         // 保留Zipkin所需的其他字段映射
       }
     }
   }
   

3. 通过Elasticsearch API上传这个模板（比如用curl或Kibana Dev Tools）：

   curl -X PUT "http://your-es-host:9200/_index_template/zipkin_span_template" -H "Content-Type: application/json" -d @your-template-file.json
   

方案2：升级Zipkin到适配ES 7.x的版本

Zipkin 2.20及以上版本已经针对Elasticsearch 7.x做了适配，移除了废弃的index.mapper.dynamic参数，也调整了索引模板的格式。直接升级Zipkin版本可以一次性解决这两类兼容性问题，是更省心的选择。

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