Skip to main content

ristretto

Stores key/value pairs in a map held in the memory-bound Ristretto cache.

# Common config fields, showing default values
label: ""
ristretto:
  default_ttl: ""

This cache is more efficient and appropriate for high-volume use cases than the standard memory cache. However, the add command is non-atomic, and therefore this cache is not suitable for deduplication.

Fields​

default_ttl​

A default TTL to set for items, calculated from the moment the item is cached. Set to an empty string or zero duration to disable TTLs.

Type: string
Default: ""

# Examples

default_ttl: 5m

default_ttl: 60s

get_retries​

Determines how and whether get attempts should be retried if the key is not found. Ristretto is a concurrent cache that does not immediately reflect writes, and so it can sometimes be useful to enable retries at the cost of speed in cases where the key is expected to exist.

Type: object

get_retries.enabled​

Whether retries should be enabled.

Type: bool
Default: false

get_retries.initial_interval​

The initial period to wait between retry attempts.

Type: string
Default: "1s"

# Examples

initial_interval: 50ms

initial_interval: 1s

get_retries.max_interval​

The maximum period to wait between retry attempts

Type: string
Default: "5s"

# Examples

max_interval: 5s

max_interval: 1m

get_retries.max_elapsed_time​

The maximum overall period of time to spend on retry attempts before the request is aborted.

Type: string
Default: "30s"

# Examples

max_elapsed_time: 1m

max_elapsed_time: 1h