jaegertracing/jaeger-operator-demo-storage-plugin

Jaeger Operator演示存储插件

概述

本Docker镜像是一个演示性质的存储插件，专为与Jaeger Operator配合使用而设计。它提供了基础的存储功能模拟，用于演示和测试Jaeger分布式追踪系统在Kubernetes环境中的存储配置与集成流程，帮助用户理解Jaeger存储后端的配置方式。

核心功能与特性

• 基础存储操作支持：模拟追踪数据的写入、读取和查询操作，满足Jaeger基本存储需求
• Jaeger Operator兼容：遵循Jaeger存储插件接口规范，可直接与Jaeger Operator集成
• 轻量级设计：镜像体积小，启动快速，适合开发测试环境部署
• 可配置参数：支持通过环境变量调整基础行为，如存储路径、日志级别等
• 演示用途优化：专注于功能演示，不包含生产级存储的可靠性与性能优化

使用场景与适用范围

• Jaeger存储配置学习：帮助开发人员理解Jaeger与存储后端的集成方式
• 开发测试环境：在本地或CI/CD环境中快速搭建Jaeger测试实例，验证存储相关功能
• Operator功能演示：展示Jaeger Operator动态配置存储插件的能力
• 教学与培训：作为教学工具，演示分布式追踪系统的存储组件工作原理

注意：本插件为演示用途，不具备生产环境所需的数据持久化、高可用性和性能保障，请勿在生产环境中使用。

使用方法与配置说明

前提条件

• Docker Engine 19.03+ 或兼容的容器运行时
• Jaeger Operator 1.28+（若用于Kubernetes环境）
• 网络连通性：插件需与Jaeger Collector实例网络可达

Docker运行命令

bash
docker run -d \
  --name jaeger-demo-storage \
  -p 9090:9090 \
  -e STORAGE_PATH=/data \
  -e LOG_LEVEL=info \
  -v $(pwd)/demo-storage:/data \
  [镜像名称]:[标签]

环境变量配置

与Jaeger Operator集成（Kubernetes环境）

1. 部署插件：在Kubernetes集群中部署插件实例（可通过Deployment实现）

   yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: jaeger-demo-storage
     namespace: observability
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: jaeger-demo-storage
     template:
       metadata:
         labels:
           app: jaeger-demo-storage
       spec:
         containers:
         - name: storage-plugin
           image: [镜像名称]:[标签]
           ports:
           - containerPort: 9090
           env:
           - name: STORAGE_PATH
             value: "/data"
           volumeMounts:
           - name: storage-volume
             mountPath: /data
         volumes:
         - name: storage-volume
           emptyDir: {}
   

2. 创建Service：为插件创建Kubernetes Service

   yaml
   apiVersion: v1
   kind: Service
   metadata:
     name: jaeger-demo-storage
     namespace: observability
   spec:
     selector:
       app: jaeger-demo-storage
     ports:
     - port: 9090
       targetPort: 9090
   

3. 配置Jaeger实例：通过Jaeger CR指定使用该演示存储插件

   yaml
   apiVersion: jaegertracing.io/v1
   kind: Jaeger
   metadata:
     name: demo-jaeger
     namespace: observability
   spec:
     storage:
       type: plugin
       plugin:
         image: [镜像名称]:[标签]
         service: jaeger-demo-storage:9090
   

注意事项

• 数据持久性：默认使用内存或临时存储，容器重启后数据会丢失（可通过挂载本地卷缓解，但仍非生产级）
• 性能限制：不支持并发控制和数据分片，高负载下可能出现性能问题
• 功能局限：仅实现基础存储接口，不支持高级功能如数据索引、过期清理等
• 安全考虑：未实现访问控制和数据加密，仅用于可信环境

故障排查

• 检查插件日志：docker logs jaeger-demo-storage 或 Kubernetes Pod日志
• 验证网络连通性：确保Jaeger Collector能访问插件服务端口（默认9090）
• 检查存储路径权限：若使用挂载卷，确保容器对挂载路径有读写权限