Configure your query caches to optimize performance and reduce costs.
If you’re hitting cache expiration issues or want to optimize your query performance, you can configure the cache settings for your workspace. This allows you to set how long queries are cached and how many queries are stored in the cache.
This feature is only available on Briefer’s enterprise plan.
These variables allow you to configure the cache mechanism for your workspace.
QUERIES_CACHE_EXPIRATION_TIME
7d
(7 days)1d
, 1h
, 1m
, and 1s
.QUERIES_CACHE_MIN_FREE_SPACE_GB
1
(1 GB)If you have Prometheus monitoring enabled, you can track the cache performance and disk usage metrics for your workspace.
The following metrics are exported to Prometheus:
jupyter_disk_usage_percentage
jupyter_free_space_gib
jupyter_volume_resize_operations
jupyter_cleanup_duration_seconds
jupyter_space_freed_bytes
jupyter_files_evicted_total
The jupyter_files_evicted_total
metric includes a label called evictionType
, which can have the following values:
normal
: files removed due to natural cache expirationforced
: files removed forcibly due to insufficient disk space