如何让JaegerQuery读取OpenSearch中的OTel追踪数据并避免数据重复？

可以实现让Jaeger Query直接读取otel-v1-apm-span-*索引的追踪数据，无需让应用重复发送数据到Jaeger，核心是配置Jaeger兼容OpenSearch存储并处理索引结构差异，具体步骤如下：

1. 确认Jaeger版本兼容性 #

确保使用的Jaeger版本在v1.30及以上，这个版本开始正式支持将OpenSearch作为存储后端（更早版本可能是实验性支持，稳定性不足）。

2. 配置Jaeger Query连接OpenSearch #

启动Jaeger Query时，通过以下关键参数指定OpenSearch存储和目标索引：

jaeger-query \
  --storage.type=elasticsearch \
  --es.server-urls=http://your-opensearch-host:9200 \
  --es.index-prefix=otel-v1-apm-span \
  --es.use-otel-span-format=true \
  # 如果OpenSearch开启了认证，添加以下参数
  --es.username=your-username \
  --es.password=your-password

• --storage.type=elasticsearch：Jaeger用该配置兼容OpenSearch存储
• --es.index-prefix=otel-v1-apm-span：指定要读取的OTel索引前缀（Jaeger会自动匹配otel-v1-apm-span-*格式的索引）
• --es.use-otel-span-format=true：开启后Jaeger会直接解析OTel格式的span数据，无需额外字段映射（需Jaeger版本支持）

3. 处理索引结构兼容（若未启用use-otel-span-format） #

如果你的Jaeger版本不支持use-otel-span-format参数，需要手动在OpenSearch中创建索引模板，将OTel的字段映射为Jaeger期望的字段：

• OTel的trace.id → Jaeger的traceID
• OTel的span.id → Jaeger的spanID
• OTel的span.name → Jaeger的operationName
• OTel的duration.us → Jaeger的duration
• OTel的start.time → Jaeger的startTime

示例索引模板核心字段映射：

{
  "mappings": {
    "properties": {
      "traceID": { "type": "keyword", "ignore_above": 256 },
      "spanID": { "type": "keyword", "ignore_above": 256 },
      "operationName": { "type": "text", "fields": { "keyword": { "type": "keyword", "ignore_above": 256 } } },
      "duration": { "type": "long" },
      "startTime": { "type": "date" }
      // 其他必要字段映射...
    }
  }
}

4. 验证配置有效性 #

• 启动Jaeger Query后，查看日志确认是否成功连接OpenSearch并读取目标索引
• 在Jaeger GUI中尝试搜索追踪数据，检查是否能正常加载和展示
• 若出现数据无法读取的情况，优先排查：索引前缀是否正确、OpenSearch权限是否足够、字段映射是否匹配

额外提示 #

• 应用端无需修改，保持原有的OLTP协议发送追踪数据到OpenSearch的流程即可
• 若OpenSearch启用了索引生命周期管理（ILM），确保otel-v1-apm-span-*索引的ILM策略不会影响Jaeger的读取权限和数据可用性
• 建议先在测试环境完成配置验证，再推广到生产环境

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