3. Jaeger 部署与配置：使用 Docker Compose 与 Kubernetes 部署 Jaeger 全栈

在生产级可观测性体系中，Jaeger 的部署方式直接影响链路数据的采集效率与运维成本。本章围绕两种主流编排方案——Docker Compose（适用于开发/测试环境）与 Kubernetes（适用于生产环境），详细拆解 Jaeger 全栈组件的部署流程、配置要点及验证方法。

3.1 Jaeger 全栈组件架构概览

在部署前，需明确 Jaeger 各核心组件的职责与数据流向。下表梳理了关键组件及其功能定位：

3.2 使用 Docker Compose 部署 Jaeger 全栈

Docker Compose 适用于本地开发、快速原型验证及 CI/CD 集成测试。以下部署方案包含 Agent、Collector、Query 及 Elasticsearch 存储。

3.2.1 编写 docker-compose.yml

version: '3.8'
services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.17.10
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
      - "9300:9300"

  jaeger-collector:
    image: jaegertracing/jaeger-collector:1.52
    ports:
      - "14269:14269"   # 健康检查
      - "14268:14268"   # 直连 HTTP
      - "14250:14250"   # gRPC
      - "9411:9411"     # Zipkin 兼容
    environment:
      - SPAN_STORAGE_TYPE=elasticsearch
      - ES_SERVER_URLS=http://elasticsearch:9200
      - COLLECTOR_QUEUE_SIZE=2000
    depends_on:
      - elasticsearch

  jaeger-query:
    image: jaegertracing/jaeger-query:1.52
    ports:
      - "16686:16686"   # UI
      - "16687:16687"   # 健康检查
    environment:
      - SPAN_STORAGE_TYPE=elasticsearch
      - ES_SERVER_URLS=http://elasticsearch:9200
    depends_on:
      - elasticsearch

  jaeger-agent:
    image: jaegertracing/jaeger-agent:1.52
    ports:
      - "5775:5775/udp" # Zipkin thrift
      - "6831:6831/udp" # Jaeger thrift compact
      - "6832:6832/udp" # Jaeger thrift binary
      - "5778:5778"     # 配置端口
    command: ["--reporter.grpc.host-port=jaeger-collector:14250"]
    depends_on:
      - jaeger-collector

3.2.2 启动与验证

1. 启动服务：docker-compose up -d
2. 检查健康状态：访问 http://localhost:14269/ 返回 {"status":"Server available"}
3. 访问 UI：浏览器打开 http://localhost:16686，确认服务列表为空（尚未接入应用）
4. 查看日志：docker-compose logs -f jaeger-collector 确认无连接错误

3.3 使用 Kubernetes 部署 Jaeger 全栈

Kubernetes 部署采用 Jaeger Operator 或 Helm Chart 两种主流方式。本节以 Helm Chart 为例，展示生产级配置。

3.3.1 部署架构图

3.3.2 使用 Helm Chart 部署

Jaeger 官方 Helm Chart 位于 jaegertracing/jaeger，支持一键部署全栈组件。以下为生产级 values.yaml 关键配置：

# values-prod.yaml
provisionDataStore:
  cassandra: false
  elasticsearch: true

elasticsearch:
  host: "elasticsearch-master.elastic-system.svc.cluster.local"
  port: 9200
  user: "elastic"
  password: "changeme"

collector:
  replicas: 3
  resources:
    requests:
      memory: "512Mi"
      cpu: "500m"
    limits:
      memory: "1Gi"
      cpu: "1"
  autoscaling:
    enabled: true
    minReplicas: 3
    maxReplicas: 10
    targetCPUUtilizationPercentage: 70

query:
  replicas: 2
  ingress:
    enabled: true
    hosts:
      - jaeger.example.com

agent:
  enabled: true
  strategy: DaemonSet
  resources:
    requests:
      memory: "128Mi"
      cpu: "100m"

storage:
  type: elasticsearch
  es:
    index-cleaner:
      enabled: true
      numberOfDays: 7
    span-storage-type: elasticsearch

部署命令：

helm repo add jaegertracing https://jaegertracing.github.io/helm-charts
helm repo update
helm install jaeger jaegertracing/jaeger -f values-prod.yaml -n observability --create-namespace

3.3.3 验证部署

3.4 配置要点与生产优化

3.4.1 存储选型对比

3.4.2 关键配置参数

• Collector 队列：COLLECTOR_QUEUE_SIZE 默认 2000，高并发场景建议提升至 5000-10000，同时增加 COLLECTOR_NUM_WORKERS 匹配 CPU 核数。
• 采样策略：生产环境使用 概率采样（如 0.1）或 速率限制采样（如 100 spans/sec），避免存储爆炸。
• 索引生命周期：ES 索引 TTL 建议 7 天，配合 ILM 策略自动删除过期索引，释放磁盘空间。
• Agent 上报：gRPC 端口 14250 比 UDP 端口 6831 更可靠，生产环境优先使用 gRPC。

3.5 部署后快速验证：发送测试 Trace

部署完成后，可通过 Jaeger 自带的 HotROD 示例应用快速验证全链路功能：

# Docker Compose 环境
docker run --rm -it \
  --network jaeger_default \
  -e JAEGER_AGENT_HOST=jaeger-agent \
  -p 8080:8080 \
  jaegertracing/example-hotrod:1.52 all

# Kubernetes 环境
kubectl run hotrod --image=jaegertracing/example-hotrod:1.52 \
  --env="JAEGER_AGENT_HOST=jaeger-agent.observability.svc.cluster.local" \
  --port=8080
kubectl expose pod hotrod --port=8080 --type=NodePort

访问 HotROD 页面（http://localhost:8080 或 NodePort），点击按钮触发请求，随后在 Jaeger UI 中搜索 hotrod 服务，应能看到完整的 Trace 链路。