Skip to main content

Expire data with Time-to-Live (TTL) in Momento Cache

This document provides an overview of Momento Cache’s time-to-live (TTL) functionality. TTL allows items to expire automatically from the cache after a specified number of seconds.

note

Momento Cache handles TTL expiry and does not consume any bandwidth for metering in your monthly transfer cost.

Expire items after a specified number of seconds

The TTL value is the number of seconds from when Momento Cache writes the item to storage until the item expires from the cache. For example, if you set an item’s TTL value to 900 seconds (15 minutes), the item will expire 15 minutes after insertion into the cache.

How to set TTL in Momento Cache

For more robust examples of the code below in multiple languages, please see "Developing applications with Momento SDKs"

There are three locations to set a TTL value:

  1. When creating a CacheClient object in a Momento SDK, you must set a TTL value for the connection. Any future SET operation using that client object will use that TTL value, unless you override the value.

    const MY_DEFAULT_TTL = 60; // This value is in seconds
    const momento = await CacheClient.create(authToken, MY_DEFAULT_TTL);
  2. In a SET operation, you can set a TTL value just for this operation and it will override the TTL value set in the CacheClient object.

    await momento.set(CACHE_NAME, 'key', 'my value', 40)
    // The number 40 is the TTL value in seconds for this item to expire and overrides the connection object's value.

    Optionally, you can omit the TTL value from the SET operation entirely and the item is inserted into the cache using the TTL value from the cache client object.

    await momento.set(CACHE_NAME, 'key', 'my value')
    // If you omit the TTL value, this will use the connection object's value.
  3. If you’re using the CLI when you run the command momento configure, it writes a configuration file (~/.momento/config) and stores a value you specify for a default TTL in that file. If you write an item with the CLI from that same user and don’t specify a TTL in the SET operation, the CLI will use the value from that configuration file.

note

Unless you copy the configuration file with your application, that file and its contents are unique to the location where you ran the momento configure command.

Frequently asked questions about TTL

Why do caches need Time to Live (TTL)?

Usually, a cache entry is not the definitive source of a piece of data. Rather, a cache entry is a faster, cheaper, and less durable way to store a piece of data, whether it's an individual record from a different database, some aggregated or computed information from multiple records or sources, or even a resource from an external, third-party application. Using a cache helps to improve latency or reduce load on a dependency in our application. In using a cache, we're anticipating that our cache entry will be requested by another client soon.

And yet, most caches don't hold onto all of their entries forever. Partly, this is a function of data staleness. The data you have stored in a cache entry may be changed over time, in which case you want a client to retrieve something fresher than the cached entry. If you have strict requirements around data consistency, you may need to directly update or remove a cache entry whenever its underlying data changes. In other situations, you may be fine serving potentially stale data for a time, while still expiring it regularly to ensure some amount of freshness.

A second consideration is simple resource constraints. Caches usually hold their data in RAM, and RAM is a scarce resource. If you never expire entries from your cache, you may find your RAM full when you try to cache new items. Your cache could reject the new entry or, more likely, choose to evict items based on a predetermined eviction algorithm.

Most caches were built for a pre-cloud world and thus require you to pre-provision specific amounts of memory available for your cache. For these caches, proper TTL management is critical as overfilling your cache can result in availability issues or cache evictions in ways you don't prefer.

In contrast, Momento is designed for the elasticity of the modern cloud. You don't need to pre-provision your cache size -- your Momento cache automatically expands and contracts based on the operations you perform against it. In the normal course of operations, Momento will not evict items based on a lack of available memory.

That being said, you should still use TTL on items in your Momento cache to avoid cache staleness and to reduce costs. Let's see how to use TTL with Momento's SimpleCache.

Details

What's the maximum TTL I can set? By default, the limit you can set the TTL for an item is 24 hours. If you need to have data in the cache beyond that time, please contact Momento Support.