xfy/lolly
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
lolly/internal/benchmark/AGENTS.md
xfy 2688ed6a9c docs: 更新 AGENTS.md 文档，新增 benchmark/netutil/scripts 目录 
- 根目录新增 scripts/ 和 .github/ 目录说明
- internal 新增 benchmark/ 和 netutil/ 目录说明
- middleware 新增 bodylimit/ 和 errorintercept/ 目录说明
- 更新日期为 2026-04-07

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 17:51:31 +08:00

1.4 KiB
Raw Permalink Blame History

benchmark

Purpose

基准测试基础设施目录，提供负载生成、Mock 后端和测试数据生成工具，用于验证服务器性能和回归检测。

Subdirectories

Directory Purpose
tools/ 基准测试工具集（Mock 后端、负载生成器、测试数据生成）

For AI Agents

Working In This Directory

  • 基准测试使用 Go 的 testing.B 框架
  • Mock 后端使用 fasthttputil.InmemoryListener 进行内存通信
  • 负载生成器支持并发请求和延迟统计

Testing Requirements

  • 运行基准测试：go test -bench=. ./internal/benchmark/...
  • 基准测试文件使用 _bench_test.go 后缀
  • 使用 make benchmark 运行完整基准测试套件

Common Patterns

  • 使用 fasthttputil.NewInmemoryListener 避免网络开销
  • 统计收集：QPS、P50/P90/P99 延迟、错误率
  • 回归检测通过 scripts/check_regression.py 自动执行

Dependencies

Internal

  • rua.plus/lolly/internal/proxy - 代理模块基准测试
  • rua.plus/lolly/internal/cache - 缓存模块基准测试
  • rua.plus/lolly/internal/loadbalance - 负载均衡基准测试

External

  • github.com/valyala/fasthttp - HTTP 客户端/服务器
  • github.com/valyala/fasthttp/fasthttputil - 内存测试工具