OpenTelemetry演示镜像

镜像概述和主要用途

本Docker镜像专为OpenTelemetry技术栈演示设计，旨在帮助用户快速搭建功能完整的演示环境，无需手动配置复杂组件。通过该镜像，用户可便捷体验OpenTelemetry的分布式追踪、指标收集、日志管理等核心功能，适用于技术学***、功能演示及配置测试场景。

核心功能和特性

• 分布式追踪支持：集成OpenTelemetry SDK，可展示跨服务调用的追踪数据，包含追踪ID、跨度（Span）信息及服务间关联关系
• 指标收集能力：预配置指标采集规则，支持展示服务性能指标（如延迟、错误率、吞吐量）及资源使用率
• 日志集成：支持将应用日志与追踪数据关联，实现日志-追踪联动分析
• 预配置后端组件：内置或关联常用后端组件（如Jaeger、Prometheus等），简化部署流程
• 即开即用：包含演示应用示例，启动后自动运行，无需额外配置即可查看效果

使用场景和适用范围

• 技术学***：开发者快速了解OpenTelemetry的核心概念与工作流程
• 功能演示：向团队或客户展示OpenTelemetry在分布式系统可观测性中的应用价值
• 配置测试：测试不同采样策略、exporter配置对追踪/指标数据的影响
• 教学培训：作为培训材料，帮助学员直观理解分布式追踪与可观测性实践

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动镜像，默认配置下将启动演示应用及关联后端组件：

docker run -d -p 8080:8080 -p 16686:16686 --name otel-demo opentelemetry-demo-image

• -p 8080:8080：映射演示应用Web界面端口
• -p 16686:16686：映射Jaeger UI端口（用于查看追踪数据）

Docker Compose配置（推荐）

对于复杂演示场景，推荐使用docker-compose整合多组件：

version: '3'
services:
  otel-demo:
    image: opentelemetry-demo-image
    ports:
      - "8080:8080"   # 演示应用界面
      - "16686:16686" # Jaeger UI
      - "9090:9090"   # Prometheus UI
    environment:
      - OTEL_TRACES_SAMPLER=parentbased_always_on # 追踪采样策略
      - OTEL_METRICS_EXPORT_INTERVAL=10s          # 指标导出间隔
    restart: unless-stopped

启动命令：

docker-compose up -d

环境变量配置

访问演示界面

• 演示应用界面：访问 http://localhost:8080，可操作生成追踪、指标数据
• Jaeger追踪界面：访问 http://localhost:16686，查询可视化追踪数据
• Prometheus指标界面（若启用）：访问 http://localhost:9090，查看指标数据

注意事项

• 本镜像仅供演示与学***使用，生产环境需调整配置及安全策略
• 部分后端组件可能占用较多资源，低配设备建议调整资源限制
• 如需持久化数据，可通过挂载卷（Volume）映射数据目录（具体路径参考镜像内部文档）