Skip to content

feat: Kafka deliverBatch fire-flush-await — 13-41x throughput (KOJAK-73) #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
endrju19 wants to merge 8 commits into
base: main
Choose a base branch
from
Open

feat: Kafka deliverBatch fire-flush-await — 13-41x throughput (KOJAK-73) #40

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
8f95f35
feat: Kafka deliverBatch fire-flush-await — 13-41x throughput (KOJAK-73)
endrju19 May 4, 2026
a6f688c
review: harden flush exception handling, slf4j logging, expanded test…
endrju19 May 4, 2026
b2eeeb6
review: address PR #40 feedback — KDoc contract, integration tests, e…
endrju19 May 14, 2026
cf26f4c
refactor: name the deliverBatch result type — DeliveryOutcome replace…
endrju19 May 14, 2026
7791c4c
Merge remote-tracking branch 'origin/main' into feature/kojak-73-kafk…
endrju19 May 17, 2026
58f7b26
fix: bound awaitOne() Future.get() to avoid indefinite stall after fl…
endrju19 May 17, 2026
c458b83
Merge remote-tracking branch 'origin/main' into feature/kojak-73-kafk…
endrju19 May 17, 2026
41e1122
chore: refresh JMH benchmark numbers + benchmark infra fixes (KOJAK-8…
endrju19 May 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -265,17 +265,17 @@ graph BT

## Performance

Throughput baseline (single instance, sync sequential delivery, MacBook M3 Max, JDK 25 LTS, April 2026):
Throughput on a single instance (MacBook M3 Max, JDK 21 LTS, May 2026):

| Transport | batchSize=10 | batchSize=100 |
|-----------|--------------|----------------|
| Kafka (`acks=all`, localhost broker) | ~110 msg/s | ~115 msg/s |
| HTTP @ webhook latency 20 ms | ~33 msg/s | ~36 msg/s |
| HTTP @ webhook latency 100 ms | ~9 msg/s | ~9 msg/s |
| Kafka (`acks=all`, localhost broker, async batch via `deliverBatch`) | **~1,790 msg/s** | **~5,180 msg/s** |
| HTTP @ webhook latency 20 ms (sync sequential — parallel `sendAsync` planned) | ~38 msg/s | ~38 msg/s |
| HTTP @ webhook latency 100 ms (sync sequential — parallel `sendAsync` planned) | ~9 msg/s | ~9 msg/s |

These numbers reflect the current sync-sequential delivery model. Throughput is bounded by per-message round-trip time × batch size.
Kafka throughput jumped 16-45× over the original sync-sequential baseline thanks to the `deliverBatch` fire-flush-await pattern. HTTP parallel `sendAsync` is next; multi-threaded scheduler scaling is in the roadmap.

Full methodology, raw JMH results, and reproduction instructions: [`benchmarks/`](benchmarks/).
Full methodology, raw JMH results, before/after per change: [`benchmarks/`](benchmarks/).

## Build

Expand Down
Loading