Skip to main content

Performance Tuning

Start With Representative Benchmarks​

Use your production-like data and query mix. Then tune by tier:

  • Hot path (storage-engine)
  • Cold path (query-engine)
  • Federated merge path (coordinator)

High-Impact Knobs​

Storage Engine​

  • SE_MEMTABLE_SIZE
  • SE_BLOCK_CACHE_SIZE
  • SE_COMPACTION_THREADS
  • SE_WAL_SYNC_MODE

Gateway​

  • GATEWAY_MAX_CONNECTIONS
  • GATEWAY_IDLE_TIMEOUT_SECS

Query Engine / Cache​

  • CACHE_ENABLED
  • CACHE_L1_MAX_CAPACITY
  • CACHE_L2_MAX_SIZE_BYTES
  • CACHE_QUERY_RESULT_TTL_SECS

Coordinator​

  • COORDINATOR_SE_WRITE_TIMEOUT_SECS
  • COORDINATOR_SE_READ_TIMEOUT_SECS

Validation Gates​

  • make e2e-single
  • make e2e-local-cluster
  • make mql-exhaustive

Source of Truth​

  • services/storage-engine/src/config.rs
  • services/gateway/src/lib.rs
  • services/coordinator/internal/lifecycle/timeout_config.go
  • services/query-engine/src/cache.rs