Zipkin 轻量级分布式追踪镜像

镜像概述和主要用途

本镜像为 Zipkin 的轻量级分发版本，专为分布式系统的追踪数据收集与存储设计。相比标准 Zipkin 镜像，其体积更小、资源占用更低，同时支持 Elasticsearch 作为存储后端，并通过 HTTP 或 gRPC 协议接收分布式追踪中的 Span 数据，适用于对资源敏感且需高效追踪能力的场景。

核心功能和特性

• 轻量级设计：优化镜像体积与运行时资源占用，适合资源受限环境
• Elasticsearch 存储：原生支持将追踪数据持久化至 Elasticsearch，支持集群化部署
• 多协议数据收集：同时支持 HTTP 和 gRPC 协议接收 Span 数据，兼容主流追踪客户端
• API 兼容性：与 Zipkin 标准 API 完全兼容，可无缝对接现有 Zipkin 生态工具
• 可配置性：通过环境变量灵活调整存储参数、收集协议及服务端口

使用场景和适用范围

• 微服务架构：适用于需要追踪跨服务请求流的微服务集群
• 资源受限环境：边缘计算、小型 Kubernetes 集群等对镜像体积和内存占用敏感的场景
• Elasticsearch 存储需求：需利用 Elasticsearch 进行追踪数据检索、分析或长期存储的业务场景
• 多协议接入：应用通过 HTTP（如 Spring Cloud Sleuth）或 gRPC（如 ***、gRPC 服务）发送追踪数据的场景

使用方法和配置说明

快速启动（Docker Run）

通过以下命令直接启动镜像，默认启用 HTTP 收集器并连接 Elasticsearch：

docker run -d \
  --name zipkin-slim \
  -p 9411:9411 \
  -e STORAGE_TYPE=elasticsearch \
  -e ES_HOSTS=[***] \
  -e COLLECTOR_HTTP_ENABLED=true \
  -e COLLECTOR_GRPC_ENABLED=true \
  openzipkin/zipkin-slim:latest

Docker Compose 配置示例

以下为包含 Elasticsearch 和 Zipkin 轻量版的完整部署示例（docker-compose.yml）：

version: '3.8'
services:
  zipkin:
    image: openzipkin/zipkin-slim:latest
    ports:
      - "9411:9411"  # HTTP 收集器端口（默认）
      - "9412:9412"  # gRPC 收集器端口（需手动映射）
    environment:
      # 存储配置
      - STORAGE_TYPE=elasticsearch
      - ES_HOSTS=[***]  # Elasticsearch 地址（多个用逗号分隔）
      - ES_INDEX=zipkin  # Elasticsearch 索引名（默认 zipkin）
      - ES_USERNAME=elastic  # Elasticsearch 认证用户名（如需）
      - ES_PASSWORD=changeme  # Elasticsearch 认证密码（如需）
      # 收集器配置
      - COLLECTOR_HTTP_ENABLED=true  # 启用 HTTP 收集器（默认 true）
      - COLLECTOR_GRPC_ENABLED=true  # 启用 gRPC 收集器（默认 false）
      # 服务配置
      - SERVICE_NAME=zipkin-slim  # 服务名称（默认 zipkin）
      - SERVER_PORT=9411  # 服务监听端口（默认 9411）
    depends_on:
      - elasticsearch

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
    environment:
      - discovery.type=single-node  # 单节点模式（测试用）
      - xpack.security.enabled=false  # 关闭认证（生产环境需启用并配置密码）
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"  # 限制 JVM 内存
    ports:
      - "9200:9200"  # Elasticsearch HTTP 端口

启动命令：docker-compose up -d

配置参数说明

核心环境变量

验证部署

1. 启动后，访问 http://<主机IP>:9411 可打开 Zipkin UI
2. 发送测试 Span 数据（以 HTTP 为例）：

   curl -X POST http://<主机IP>:9411/api/v2/spans \
     -H "Content-Type: application/json" \
     -d '[{"name":"test-span","traceId":"abc123","id":"def456","timestamp":1620000000000,"duration":100}]'
   

3. 在 Zipkin UI 的 "Find Traces" 页面搜索 traceId:abc123，应能查询到测试 Span

注意事项

• Elasticsearch 需提前部署并确保网络可达，生产环境建议配置集群模式及认证
• gRPC 收集器默认禁用，启用时需手动映射容器端口（如 -p 9412:9412）
• 资源受限环境可通过 JAVA_OPTS 调整 JVM 参数（如 -e JAVA_OPTS="-Xms256m -Xmx256m"）限制内存使用