Skip to main content

memory

Stores key/value pairs in a map held in memory. This cache is therefore reset every time the service restarts. Each item in the cache has a TTL set from the moment it was last edited, after which it will be removed during the next compaction.

# Common config fields, showing default values
label: ""
memory:
ttl: 300
compaction_interval: 60s
init_values: {}

The compaction interval determines how often the cache is cleared of expired items, and this process is only triggered on writes to the cache. Access to the cache is blocked during this process.

Item expiry can be disabled entirely by either setting the compaction_interval to an empty string.

The field init_values can be used to prepopulate the memory cache with any number of key/value pairs which are exempt from TTLs:

memory:
ttl: 60
init_values:
foo: bar

These values can be overridden during execution, at which point the configured TTL is respected as usual.

Fields

ttl

The TTL of each item in seconds. After this period an item will be eligible for removal during the next compaction.

Type: int
Default: 300

compaction_interval

The period of time to wait before each compaction, at which point expired items are removed.

Type: string
Default: "60s"

shards

A number of logical shards to spread keys across, increasing the shards can have a performance benefit when processing a large number of keys.

Type: int
Default: 1

init_values

A table of key/value pairs that should be present in the cache on initialization. This can be used to create static lookup tables.

Type: object
Default: {}

# Examples
init_values:
Nickelback: "1995"
Spice Girls: "1994"
The Human League: "1977"