jaegertracing/jaeger-snapshot

Jaeger V2 (基于OpenTelemetry Collector) 镜像文档

镜像概述

Jaeger V2镜像（实验性）是基于OpenTelemetry Collector构建的分布式追踪系统实现，旨在提供高性能、可扩展的追踪数据收集、处理和可视化能力。作为Jaeger项目的下一代版本，该镜像整合了OpenTelemetry的标准化数据采集能力，支持多种追踪协议，适用于分布式系统的可观测性场景。

核心功能与特性

• OpenTelemetry原生集成：基于OpenTelemetry Collector构建，支持OTLP（OpenTelemetry Protocol）等标准化协议，兼容OpenTelemetry生态工具链。
• 多协议数据采集：支持接收Jaeger Thrift、Zipkin、OTLP（gRPC/HTTP）等多种格式的追踪数据。
• 灵活的数据处理：内置数据过滤、转换、采样等处理能力，可通过配置文件自定义处理逻辑。
• 分布式追踪可视化：集成Jaeger UI，提供服务依赖图、追踪详情查询、性能指标展示等可视化功能。
• 可扩展存储：支持内存、Elasticsearch、Cassandra等多种存储后端，满足不同规模场景需求。

使用场景与适用范围

• 分布式系统追踪：适用于微服务架构、云原生应用等分布式系统，追踪请求从发起至完成的全链路路径。
• 性能问题定位：通过分析追踪数据，定位系统中的延迟瓶颈、服务依赖问题及错误根源。
• 可观测性平台集成：作为可观测性平台的追踪组件，与Prometheus（指标）、Loki（日志）等工具联动，构建完整可观测性体系。
• 开发与测试环境：实验性版本适合在开发、测试环境中验证Jaeger V2的新特性与功能。

注意：该镜像为实验性版本（experimental），稳定性和功能完整性可能未达生产环境要求，不建议直接用于生产系统。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Jaeger V2容器（默认配置，使用内存存储）：

bash
docker run -d \
  --name jaeger-v2 \
  -p 16686:16686 \  # Jaeger UI端口
  -p 4317:4317 \    # OTLP gRPC接收端口
  -p 4318:4318 \    # OTLP HTTP接收端口
  -p 9411:9411 \    # Zipkin接收端口
  jaegertracing/jaeger-v2:latest

启动后，可通过 http://localhost:16686 访问Jaeger UI，查看追踪数据。

Docker Compose配置示例

以下是使用Docker Compose部署Jaeger V2+Elasticsearch（持久化存储）的示例：

yaml
version: '3'
services:
  jaeger:
    image: docker.xuanyuan.run/jaegertracing/jaeger-v2:latest
    ports:
      - "16686:16686"   # UI
      - "4317:4317"     # OTLP gRPC
      - "4318:4318"     # OTLP HTTP
    environment:
      - SPAN_STORAGE_TYPE=elasticsearch  # 指定存储类型为Elasticsearch
      - ES_SERVER_URLS=http://elasticsearch:9200  # Elasticsearch地址
    depends_on:
      - elasticsearch

  elasticsearch:
    image: ***-elastic.xuanyuan.run/elasticsearch/elasticsearch:7.17.0
    environment:
      - discovery.type=single-node
      - xpack.security.enabled=false
    ports:
      - "9200:9200"
    volumes:
      - es-data:/usr/share/elasticsearch/data

volumes:
  es-data:

启动命令：docker-compose up -d

核心配置参数

环境变量配置

端口映射说明

自定义配置

如需自定义OpenTelemetry Collector处理逻辑（如添加处理器、扩展输出等），可通过挂载配置文件实现：

1. 创建本地配置文件 collector-config.yaml，示例内容：

   yaml
   receivers:
     otlp:
       protocols:
         grpc:
         http:
   
   processors:
     batch:
   
   exporters:
     jaeger_storage:
   
   service:
     pipelines:
       traces:
         receivers: [otlp]
         processors: [batch]
         exporters: [jaeger_storage]
   

2. 启动容器时挂载配置文件：

   bash
   docker run -d \
     --name jaeger-v2 \
     -p 16686:16686 -p 4317:4317 \
     -v $(pwd)/collector-config.yaml:/etc/jaeger/collector-config.yaml \
     -e COLLECTOR_CONFIG=/etc/jaeger/collector-config.yaml \
     docker.xuanyuan.run/jaegertracing/jaeger-v2:latest
   

注意事项

• 实验性限制：作为实验性版本，部分功能可能不稳定，且不保证向后兼容性。
• 存储性能：默认内存存储（memory）仅适合测试场景，生产环境需使用Elasticsearch等持久化存储。
• 资源需求：根据追踪数据量调整容器CPU/内存资源，避免因资源不足导致数据丢失或性能下降。
• 安全配置：生产环境部署时需配置网络隔离、认证授权（如Elasticsearch访问权限）等安全措施。