fortio/fortiotel

Fortio with Open Telemetry (OTEL) 镜像文档

镜像概述

本镜像基于Fortio工具构建，集成了Open Telemetry (OTEL)追踪支持。Fortio是一款轻量级高性能负载测试与性能基准测试工具，支持HTTP/HTTPS/UDP等协议的流量生成；OTEL集成则提供了分布式追踪能力，可在测试过程中自动收集、导出追踪数据，帮助用户深入分析系统在不同负载条件下的性能表现与瓶颈。

核心功能和特性

Fortio基础功能

• 支持HTTP/HTTPS/UDP协议的负载测试，可模拟高并发请求
• 可配置并发用户数、请求速率、测试时长等参数
• 实时生成性能指标（延迟分布、吞吐量、错误率等）
• 支持TCP连接复用、HTTP/2、WebSocket等高级特性
• 轻量级设计，资源占用低，适合在容器环境中运行

OTEL追踪特性

• 自动生成测试过程中的分布式追踪数据（跨度、属性、事件等）
• 支持OTLP协议，可对接主流追踪后端（Jaeger、Zipkin、Datadog等）
• 内置上下文传播机制，支持跨服务追踪数据关联
• 可自定义服务名称、追踪采样率等配置
• 兼容OTEL语义约定，追踪数据标准化程度高

使用场景和适用范围

• 分布式系统性能测试：在微服务架构中，通过追踪数据定位跨服务调用延迟瓶颈
• 负载与追踪联动分析：结合性能指标与追踪数据，建立系统行为与负载的关联模型
• 持续集成/部署验证：在CI/CD流程中集成，通过追踪数据验证性能 regression
• 系统优化验证：对比优化前后的追踪数据，量化性能改进效果
• 教学与调试：作为分布式追踪实践工具，演示追踪数据生成与分析流程

使用方法

基本使用流程

1. 配置OTEL后端（如启动Jaeger容器）
2. 运行本镜像，通过环境变量指定OTEL配置
3. 执行负载测试命令，生成并导出追踪数据
4. 在OTEL后端查看与分析追踪结果

Docker Run命令示例

1. 对接Jaeger后端的HTTP负载测试

bash
# 启动Jaeger（若未部署）
docker run -d --name jaeger -p 16686:16686 -p 4317:4317 jaegertracing/all-in-one:latest

# 运行Fortio OTEL镜像，测试目标服务http://target-service:8080/health
docker run --rm \
  -e OTEL_EXPORTER_OTLP_ENDPOINT=http://host.docker.internal:4317 \
  -e OTEL_SERVICE_NAME=fortio-load-tester \
  -e OTEL_TRACES_SAMPLER=always_on \
  fortio/fortio-otel \
  load -c 10 -qps 100 -t 30s http://target-service:8080/health

2. 自定义追踪属性与UDP测试

bash
docker run --rm \
  -e OTEL_EXPORTER_OTLP_ENDPOINT=https://your-otel-collector:4317 \
  -e OTEL_SERVICE_NAME=fortio-udp-tester \
  -e OTEL_RESOURCE_ATTRIBUTES=environment=test,team=backend \
  fortio/fortio-otel \
  load -protocol udp -c 5 -qps 50 -t 10s udp://target-service:5000

测试命令参数说明

Fortio负载测试核心参数（load子命令）：

• -c：并发用户数（默认1）
• -qps：每秒请求数（默认0，即不限制）
• -t：测试时长（默认30s）
• -httpbufferkb：HTTP请求缓冲区大小（KB）
• -keepalive：是否启用TCP长连接（默认true）

配置说明

核心OTEL环境变量

注意事项

• OTEL后端需支持OTLP协议（默认使用gRPC，HTTP需指定OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf）
• 高并发场景下建议适当降低采样率（如0.1），避免追踪数据量过大
• 容器网络需确保与OTEL后端互通（如使用--network参数指定共享网络）
• 测试目标服务需支持HTTP/2或HTTP/1.1（根据协议配置），UDP测试需确保目标端口可访问