Skip to content

chore: consolidate benchmark scripts and documentation - #54

Merged
kacy merged 4 commits into
mainfrom
chore/consolidate-benchmarks
Feb 7, 2026
Merged

chore: consolidate benchmark scripts and documentation#54
kacy merged 4 commits into
mainfrom
chore/consolidate-benchmarks

Conversation

@kacy

@kacy kacy commented Feb 7, 2026

Copy link
Copy Markdown
Owner

summary

  • consolidated all benchmark scripts from scripts/ into bench/ folder
  • expanded bench/README.md with comprehensive benchmark results:
    • ember concurrent vs sharded mode comparison
    • dragonfly comparison stats
    • persistence impact measurements
    • scaling efficiency data
  • simplified main README.md benchmarks section to show high-level comparison
  • updated Makefile targets to reference new script locations

what was tested

  • verified all scripts execute correctly from new location
  • confirmed make bench-quick, make bench-compare, make bench-memory, make bench-full work
  • ran cargo test --workspace - all 609 tests pass

design considerations

moved to a two-tier documentation approach:

  • main README: quick comparison table for first impressions
  • bench/README.md: full methodology, detailed results, and reproduction instructions

this keeps the main readme scannable while providing depth for users who want to benchmark themselves.

kacy added 4 commits February 7, 2026 16:29
- move all scripts from scripts/ to bench/ folder
- consolidate detailed benchmark results in bench/README.md
- simplify main README with high-level comparison table
- update Makefile targets to reference new script locations
- add sharded mode, dragonfly, and persistence stats to docs
- add ember concurrent mode (--concurrent flag)
- keep ember sharded mode (default)
- compare both against redis and dragonfly
- show ratio comparisons for each pairing
- add --threads flag to redis-benchmark calls (defaults to CPU cores)
- multi-threaded benchmark client generates more load
- previous results were bottlenecked by single-threaded client
tested on c2-standard-8 with multi-threaded benchmark client:
- concurrent: 1.86M SET/sec, 2.49M GET/sec (1.8-2.1x vs redis)
- sharded: 864k SET/sec, 966k GET/sec (0.9x vs redis)
- vs dragonfly: 3.3-3.8x faster in concurrent mode
- memory: 161 bytes/key (redis: 105 bytes/key)
- p99 latency: 0.4ms for all modes
@kacy
kacy merged commit 5e7d33c into main Feb 7, 2026
5 checks passed
@kacy
kacy deleted the chore/consolidate-benchmarks branch February 7, 2026 21:45
kacy added a commit that referenced this pull request Feb 11, 2026
* chore: consolidate benchmark scripts and documentation

- move all scripts from scripts/ to bench/ folder
- consolidate detailed benchmark results in bench/README.md
- simplify main README with high-level comparison table
- update Makefile targets to reference new script locations
- add sharded mode, dragonfly, and persistence stats to docs

* fix: update benchmark script to test all four modes

- add ember concurrent mode (--concurrent flag)
- keep ember sharded mode (default)
- compare both against redis and dragonfly
- show ratio comparisons for each pairing

* perf: use multi-threaded redis-benchmark for accurate results

- add --threads flag to redis-benchmark calls (defaults to CPU cores)
- multi-threaded benchmark client generates more load
- previous results were bottlenecked by single-threaded client

* docs: update benchmark results with accurate GCP numbers

tested on c2-standard-8 with multi-threaded benchmark client:
- concurrent: 1.86M SET/sec, 2.49M GET/sec (1.8-2.1x vs redis)
- sharded: 864k SET/sec, 966k GET/sec (0.9x vs redis)
- vs dragonfly: 3.3-3.8x faster in concurrent mode
- memory: 161 bytes/key (redis: 105 bytes/key)
- p99 latency: 0.4ms for all modes
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