Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

nginx_tcp_to_blackhole

Case Metadata

  • Case ID: nginx_tcp_to_blackhole
  • Category: tcp
  • Capability: parse_trans
  • Topology: tcp -> blackhole
  • Platforms: Mac M4 Mini / Linux (AWS EC2)

Scenario Definition

  • 日志类型: Nginx Access Log (239B)
  • 平均大小: 239B
  • 能力: parse_trans
  • 输入/输出: TCP -> BlackHole
  • 说明: Nginx Access Log 场景,TCP 输入到 BlackHole 输出,执行 日志解析+转换 能力。

Dataset Contract

  • 输入数据: benchmark/case_tcp/parse_to_blackhole/data/in_dat/gen.dat(数据文件) / benchmark/case_tcp/parse_to_blackhole/conf/wpgen.toml(生成器配置)
  • 事件数: 支持 -m(中等规模)与 -c(指定条数),事件含义与生成器配置保持一致
  • 编码/分隔: UTF-8 / LF
  • 混合比例: 不适用

Configuration Binding

  • WarpParse: benchmark/case_tcp/parse_to_blackhole/conf/wparse.toml(规则目录:benchmark/models/wpl/nginx;解析+转换使用 benchmark/models/oml)
  • Vector-VRL: benchmark/vector/vector-vrl_transform/nginx_tcp_to_blackhole.toml
  • Vector-Fixed: benchmark/vector/vector-fixed_transform/nginx_tcp_to_blackhole.toml
  • Logstash: benchmark/logstash/logstash_trans/nginx_tcp_to_blackhole.conf

Execution Contract

  • 结束条件: 消费完等量事件(或按数据集规模),如需按时间结束请补充
  • 并发/Worker: 默认配置(wparse 的 parse_workers 以配置为准)
  • 重复次数: 默认单次;建议 N=3 取 median

Metrics

  • EPS: Events Per Second
  • MPS: MiB/s,公式:MPS = EPS * AvgEventSize / 1024 / 1024
  • CPU: 多核累计百分比(例如 800% ≈ 8 个逻辑核满载)
  • MEM: 进程内存占用(Avg/Peak)
  • Rule Size: 规则配置体积

Performance Data

Linux (AWS EC2)

引擎EPSMPSCPU (Avg/Peak)MEM (Avg/Peak)性能倍数
WarpParse524,800119.62608% / 637%189 MB / 410 MB1.34x
Vector-VRL392,20089.39472% / 512%162 MB / 166 MB1.0x
Vector-Fixed208,90047.61502% / 537%146 MB / 151 MB0.53x
Logstash107,14224.42520% / 552%1163 MB / 1243 MB0.27x

macOS (Mac M4 Mini)

引擎EPSMPSCPU (Avg/Peak)MEM (Avg/Peak)性能倍数
WarpParse1,382,800315.19602% / 656%279 MB / 369 MB1.35x
Vector-VRL1,024,300233.47534% / 618%232 MB / 235 MB1.0x
Vector-Fixed595,800135.80543% / 651%214 MB / 219 MB0.58x
Logstash357,14281.40685% / 861%1219 MB / 1258 MB0.35x

Correctness Check

  • 对齐说明: 参见 benchmark/report/test_sample.md
  • 抽样方式: 运行 file 输出链路进行抽样对比,检查关键字段与 Golden 输出一致
  • 输出路径约定: benchmark/case_tcp/parse_to_file/data/out_dat/(如需校验可切换到 file 输出)

Notes

  • Loopback TCP: TCP 场景均使用 127.0.0.1 回环,不受物理网卡限制
  • 实例规格: 若为 TBD,loopback TCP 口径不受实例带宽/ENI 影响
  • 限制: 单机测试,未覆盖分布式/HA

References

  • Mac 报告: benchmark/report/report_mac.md#321-nginx-access-log-239b(章节 3.2.1)
  • Linux 报告: benchmark/report/report_linux.md#321-nginx-access-log-239b(章节 3.2.1)
  • 规则说明: benchmark/report/test_rule.md
  • 样本对齐: benchmark/report/test_sample.md