jacksondavenport/sample-python-app-cron

镜像概述

本镜像为Python应用，用于生成并提交示例追踪数据，可生成包含1个父span和2个子span的追踪链路（持续约0.5秒），主要用于测试、演示分布式追踪系统的功能与数据处理流程。

核心功能与特性

• 示例追踪结构：生成标准追踪数据，包含1个父span及2个子span，模拟典型分布式追踪场景
• 可配置发送参数：通过环境变量灵活调整追踪发送行为：
  • TRACE_COUNT：控制发送的追踪数据总条数，默认值为100
  • FREQUENCY：控制每条追踪数据发送间隔时间（秒），默认值为0.5
  • EXIT_WAIT：控制所有追踪发送完成后等待的时间（秒），默认值为0（立即退出）

使用场景与适用范围

• 分布式追踪系统（如Jaeger、Zipkin、OpenTelemetry等）的功能验证与兼容性测试
• 追踪数据生成流程、发送机制的演示与教学
• 性能测试环境中模拟追踪数据负载，验证后端处理能力

使用方法与配置说明

环境变量配置

应用行为通过以下环境变量自定义，支持运行时动态调整：

Docker运行示例

默认配置运行

使用默认参数发送100条追踪，每条间隔0.5秒，完成后立即退出：

bash
docker run sample-trace-app

自定义参数运行

通过--env参数覆盖默认环境变量，调整发送数量、间隔时间或退出等待时间：

bash
# 发送200条追踪，每条间隔1秒，完成后等待10秒再退出
docker run \
  --env TRACE_COUNT=200 \
  --env FREQUENCY=1 \
  --env EXIT_WAIT=10 \
  sample-trace-app

运行流程说明

1. 容器启动后，应用初始化并读取环境变量配置
2. 按TRACE_COUNT设置生成指定数量的追踪数据，每条包含1个父span和2个子span
3. 按FREQUENCY设置的时间间隔依次发送所有追踪数据
4. 所有数据发送完成后，根据EXIT_WAIT设置等待指定时间（或立即）退出容器