zoo-framework 0.11.0
性能评测

zoo-bench 报告

运行环境

数据：运行环境

zoo-bench 报告

负载

• 构成：单位工作 = JSON 序列化 + 反序列化 + 字符串拼接，重复若干次以达到目标耗时；档位由 matrix.yaml 的 body_tiers_us 声明
• 负载是替身，不是真实 trace：形状接近“取一帧数据 -> 序列化 -> 解析 -> 字符串处理”这类业务动作，但仓库内没有真实样本，结论的适用性以此为前提

数据：负载

zoo-bench 报告

结论摘要

• 被测框架 zoo 的执行体时长达到约 2700 微秒 及以上时，其框架开销占端到端的比例降到 15% 以下；短于此档位，选用它的主要代价就是框架开销本身。
• 并发度 1、执行体 40 微秒 下，被测框架比 process_pool 快 2.14x（该并发度所测档位中最快的一档）。
• 并发度 1 下，执行体时长超过约 40 微秒 后，apscheduler 不再快于被测框架。
• 并发度 4 下，执行体时长超过约 40 微秒 后，apscheduler 不再快于被测框架。
• 并发度 16 下，执行体时长超过约 40 微秒 后，apscheduler 不再快于被测框架。
• 并发度 64 下，执行体时长超过约 40 微秒 后，apscheduler 不再快于被测框架。
• 并发度 1 下，所测档位内 asyncio_pool 始终快于被测框架——这类档位正是本报告的公开不利数据。

数据：结论摘要

结论摘要

本章其余明细在全文里

幻灯片为了「一页一个结论」只放了本章的前 2 页；余下 6 页的逐单元数值、分位数与原始样本都在全文的同一章节里，逐字可核。

全文：同目录 report.md 的「结论摘要」章节

维度：延迟分位数与抖动

延迟分位数与抖动：并发度 1

并发度 1 · 端到端 / 并发度

数据：zoo-bench「延迟分位数与抖动」· 并发度 1 · 逐单元数值与分位数见 report.md 的同一章节

zoo-bench 报告

维度：延迟分位数与抖动

端到端 / 并发度；分位数与相对离散度同表给出，只给中位数的度量不合格

数据：维度：延迟分位数与抖动

维度：框架自身开销占比

框架自身开销占比：并发度 1

并发度 1 · 框架自身开销

数据：zoo-bench「框架自身开销占比」· 并发度 1 · 逐单元数值与分位数见 report.md 的同一章节

zoo-bench 报告

维度：框架自身开销占比

开销 = 端到端/并发度 - 同一次运行内实测的执行体耗时（不做跨运行减法）。带 — 的格：该并发度超出这台机器的并行能力，执行体自报耗时含超订的调度等待，与该行的每任务端到端不可比，故不给开销数字（端到端与吞吐见各自的维度）

数据：维度：框架自身开销占比

维度：吞吐与并发伸缩

吞吐与并发伸缩：并发度 1

并发度 1 · 吞吐

数据：zoo-bench「吞吐与并发伸缩」· 并发度 1 · 逐单元数值与分位数见 report.md 的同一章节

zoo-bench 报告

维度：吞吐与并发伸缩

吞吐 = 并发度 / 端到端中位数；随并发度是否继续上升即为伸缩性

数据：维度：吞吐与并发伸缩

zoo-bench 报告

维度：开销归因

口径：把每任务端到端拆成提交侧 / 手交 / 执行体 / 回程四段，并在同一档位与并发度下与各对照方案逐段对照，回答「超出对照的部分落在哪一段」。它是诊断而非主证据：抽样一小批档位，且不与对照方案比总开销。手交为负不是错误：那表示提交调用还没返回、执行体就已经开跑——把建线程一类工作算进提交侧的方案就会这样（实测 bare_thread 手交 -343 微秒）。回程含完成信号的等待（排空返回前的最后一段），它与主测量是同一口径

状态：ok

本维度是诊断不是主证据：抽样的档位与并发度固定为一小批，不覆盖矩阵里的全部单元。并发度上界取机器的并行能力——超过它时量到的是争用；

抽样档位（微秒）：40、10000；并发度：[1, 4]；该机器并行能力：4

数据：维度：开销归因

维度：开销归因

本章其余明细在全文里

幻灯片为了「一页一个结论」只放了本章的前 2 页；余下 9 页的逐单元数值、分位数与原始样本都在全文的同一章节里，逐字可核。

全文：同目录 report.md 的「维度：开销归因」章节

zoo-bench 报告

维度：原生任务线：同一被测对象的三种执行形态

口径：该线独立测量：它不进入主矩阵的透视表与交叉点，其数值也不可与那些表里的对照方案横向比较

该线结论：ok

等价性门禁：通过，15 条判据输入与 Python 参照逐字节比对（输入上限 256 字节）

所测任务 modbus_rtu.parse_response——Modbus RTU 响应帧解析：输入是一条裸 RTU ADU 响应帧（不含任何传输层封装），其长度即该档位的帧字节

规模档位 R1、R8、R125（帧字节 7、21、255）；并发度 1、4、16、64；每格预热 100 轮 + 采样 100 轮，每个并发度一个子进程（共 4 个）

规模分界（只在判定并发度 1 上判读）：原生形态更快的档位：R8、R125；更慢的档位：R1；分辨不出的档位：无。分界点：帧不超过 7 字节时原生形态不快，达到或超过 21 字节时更快

每个数值是每任务端到端（正式采样轮的中位数）——与主矩阵延迟维度同一口径

数据：维度：原生任务线：同一被测对象的三种执行形态

维度：原生任务线：同一被测对象的三种执行形态

本章其余明细在全文里

幻灯片为了「一页一个结论」只放了本章的前 2 页；余下 2 页的逐单元数值、分位数与原始样本都在全文的同一章节里，逐字可核。

全文：同目录 report.md 的「维度：原生任务线：同一被测对象的三种执行形态」章节

被测框架在哪些档位更快

被测框架在哪些档位更快（续）

数据：被测框架在哪些档位更快

zoo-bench 报告

公开的不利数据

被测框架处于劣势的档位（两侧差异大于该档位的带宽）。这部分缺失的报告不合格——一份只展示自己赢的报告，读者有理由认为它不可信。差异小于带宽的档位不在本节，而在「分不出胜负」那一节：那是判据的结果，不是把它们藏起来

数据：公开的不利数据

公开的不利数据

公开的不利数据（续）

数据：公开的不利数据

zoo-bench 报告

分不出胜负的档位

两侧分不出胜负的档位：差异小于该档位的带宽。带宽取自同一次运行内两侧各自的跨轮离散度（每任务中位数的标准差 / 中位数）之和，故它随样本变化，读者可用留档里的逐轮样本自行复核。它同样覆盖全部所测档位、逐项写明原因——本节不是藏东西的地方：把噪声级差异报成「快 1.00x」才是

判据：带宽 = 被测框架侧与对照侧各自的跨轮相对离散度之和；单侧的跨轮相对离散度 = 该单元逐轮的「每任务中位数」的标准差 / 中位数

本期带宽：1.0% 到 57.0%（随各档位的离散度不同而不同）。

数据：分不出胜负的档位

分不出胜负的档位

本章其余明细在全文里

幻灯片为了「一页一个结论」只放了本章的前 2 页；余下 1 页的逐单元数值、分位数与原始样本都在全文的同一章节里，逐字可核。

全文：同目录 report.md 的「分不出胜负的档位」章节

口径局限与偏差来源

口径局限与偏差来源（续）

• 口径说明（thread_pool）：concurrent.futures.ThreadPoolExecutor，池大小 = 并发度；线程复用、无任务队列语义
• 口径说明（zoo）：端到端终点为「worker 完成并在飞表注销」；框架其后的结果投递按世代分流：上一代的投递路径是坏的（dispatch 按 reactor_name 而非主题查响应器，每次调用必抛），完成信号只能取自框架内部回调；当前代该处已修好，完成信号取自框架自己的结果响应器。口径说明：完成信号由本档的 Condition 给出，每任务一次通知的开销计入其端到端；该方向的偏差使被测框架看起来更慢，即对被测框架不利而非有利
• 不给出开销数字的组：以下 (适配器, 并发度) 组的并发度超过这次运行所在机器的并行能力：执行体自报的耗时里含超订带来的调度等待，与「墙钟 / 并发度」不是同一件事，相减的结果没有意义（实测出现过负值，并衍生出无意义的变化倍数）。故本报告对它们不给框架开销、也不给交叉点；端到端、吞吐与执行体自报值仍然有效，原始留档里的字段也一个没删。判据取自环境自述的逻辑核数，另有一条证据性兜底：算出来的开销为负同样判为不可读——框架只会加时间不会减时间
• 未参与判定的自检项：这些单元的执行体档位偏差未参与判定（并发度高于最低档，或档位短到墙钟受调度颗粒度支配）。原始值仍在场，但那两处的墙钟不足以断定校准是否正确——读这些档位的数字时要把它算进去

绝对耗时：仅在同一次运行内部有效，不可跨运行比较

数据：口径局限与偏差来源

zoo-bench 报告

自检

• 测量自检整体：通过
• 进程隔离：{'parent_pid': 71066, 'child_pids': [71522, 71525, 71528, 71531, 71534, 71540, 71546, 71552, 71558, 71576, 71594, 71612, 71630, 71687, 71745, 71800, 71866, 71868, 71870, 71872, 71874, 71879, 71884, 71890, 71895, 71912, 71929, 71946, 71963, 72025, 72087, 72152, 72221, 72255, 72289, 72323, 72357, 72490, 72623, 72756, 72889, 73418, 73947, 74476, 75006, 77119, 79232, 81345, 83460, 83464, 83468, 83472, 83476, 83483, 83490, 83497, 83504, 83523, 83542, 83561, 83580, 83647, 83714, 83781, 83852, 83854, 83856, 83858, 83860, 83865, 83870, 83875, 83880, 83897, 83914, 83931, 83948, 84004, 84061, 84120, 84187, 84189, 84191, 84193, 84195, 842
• 00, 84205, 84210, 84215, 84232, 84251, 84268, 84285, 84350, 84415, 84480], 'all_distinct': True, 'none_equals_parent': True}

数据：自检