Skip to main content

Intelligent Cache

The intelligent-cache plugin integrates in query-engine and can be enabled/disabled at runtime via environment variables.

Compile and Runtime Model

  • Compile: query-engine default feature includes intelligent-cache.
  • Runtime: plugin activates when CACHE_ENABLED=true.

Code anchors:

  • services/query-engine/Cargo.toml
  • services/query-engine/src/cache.rs
  • services/query-engine/src/plugins/registry.rs

Key Runtime Variables

  • CACHE_ENABLED
  • CACHE_L1_MAX_CAPACITY
  • CACHE_L2_ENABLED
  • CACHE_L2_PATH
  • CACHE_L2_MAX_SIZE_BYTES
  • CACHE_L3_ENABLED
  • CACHE_L3_ADDRESSES
  • CACHE_L3_SERVER_ENABLED
  • CACHE_L3_BIND_ADDRESS
  • CACHE_QUERY_RESULT_TTL_SECS

Local Compose Defaults

Local compose enables cache-related variables for query-engine (see docker-compose.yml).

Verification

  • Query-engine startup logs confirm plugin activation.
  • Metrics and stats endpoints expose cache behavior for validation.