Skip to content

Document the benchmark harness's methodology gap - #8

Merged
sinhaparth5 merged 1 commit into
masterfrom
document-benchmark-methodology-gap
Sep 3, 2026
Merged

Document the benchmark harness's methodology gap#8
sinhaparth5 merged 1 commit into
masterfrom
document-benchmark-methodology-gap

Conversation

@sinhaparth5

Copy link
Copy Markdown
Owner

Summary

Docs-only. Records why the fixed SqpollEngine head-to-head against POSIX pread/pwrite, libaio, and plain io_uring doesn't settle the paper's core hypothesis, and what the harness needs before it can.

What happened

Ran all five backends on the same n2-standard-4 box to check whether Phase 5's original "SqpollEngine trailing every baseline" finding still held after the shared-poller and backoff fixes. It did, by a wide margin at every thread count. Before writing that up as a finding, checked why the baseline numbers looked too fast to be real disk I/O and found two problems in benchmarks/iops_throughput_benchmark.cpp:

  • MakeScratchFile() never opens with O_DIRECT, and the working set is 64 MiB. On a box with much more RAM than that, every backend's I/O after the first pass comes from the page cache, not the drive. POSIX pread/pwrite hit 698K-1.3M IOPS in this run, which is DRAM speed.
  • Every backend, SqpollEngine included, runs at queue depth 1: submit one request, block-wait for that exact completion, submit the next. An async batching design has nothing to amortize its syscall-avoidance over at depth 1, so losing here is expected, not a regression.

Neither problem is new; both were already true of every prior run of this suite. This PR just writes that down instead of letting the "trailing every baseline" line stand unqualified.

Next (not in this PR)

Two items recorded as unstarted work in ROADMAP.md: O_DIRECT with sector-aligned buffers so the baselines hit the actual device, and a queue-depth sweep (1/8/32/64/128) across all four backends being compared. Planned for a follow-up branch, not started here.

Testing

None needed; ROADMAP.md only.

Ran the fixed SqpollEngine head-to-head against POSIX pread/pwrite,
libaio, and plain io_uring on the same NVMe box, to check whether
Phase 5's original "trailing every baseline" finding still held. It
did, at every thread count, but the comparison itself is invalid: the
scratch file never opens with O_DIRECT and its 64 MiB working set
fits in the page cache, so the syscall baselines are measuring DRAM
speed, not disk speed, and every backend including SqpollEngine runs
at queue depth 1, which never gives an async batching design anything
to amortize its syscall-avoidance over.

Neither problem is a regression from today's other changes. Both were
already true of every prior run of this benchmark. Recorded as
unstarted work: O_DIRECT with aligned buffers so the baselines hit
the real device, and a queue-depth sweep across all four backends
being compared, not just the SQPOLL ones.
@sinhaparth5
sinhaparth5 merged commit cfc6301 into master Sep 3, 2026
@sinhaparth5
sinhaparth5 deleted the document-benchmark-methodology-gap branch September 3, 2026 08:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant