SDK Client configuration objects

Configuration objects contain the settings necessary for how a Momento client should connect to Momento services. The Configuration object controls settings such as timeouts, retries, logging, middleware, read concern, and more.

Each SDK contains pre-built Configuration objects to help get you up and running as quickly as possible. We did the hard work of tuning for various deployment environments so you can focus on the things unique to your business. (We even have a blog series about it! Shockingly simple: Cache clients that do the hard work for you)

Pre-built configurations come with a latest() version, which will always give you the latest recommended configuration for a given environment. For example,

JavaScript

Configurations.InRegion.Default.latest();

info

Full example code and imports can be found here

Rust

  let _config = momento::cache::configurations::InRegion::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionLowLatency() {
  let _config = momento::cache::configurations::LowLatency::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationLambdaLatest() {
  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

info

Full example code and imports can be found here

The latest() pre-built configuration may change between SDK releases as we continue to test, tune, and deliver better settings. If you would like to ensure your configuration does not change with an SDK upgrade, we provide fixed versions such as v1(), which are guaranteed to remain static from one release to the next. For example,

JavaScript

Configurations.InRegion.Default.v1();

info

Full example code and imports can be found here

If you need a custom configuration, you can build your own Configuration object. See the examples in the Configurations namespace in the source code of each SDK to see how they are constructed.

We hope these configurations will meet the needs of most use cases, but if you find them lacking in any way, please open a GitHub issue on that SDK repo, or contact us at support@momentohq.com. We would love to hear about your use case so we can fix or extend the pre-built configurations to better support you.

Pre-built configurations

Here are some of the pre-built configurations that you might be interested in.

Laptop

Configurations.Laptop is a development environment, just for poking around on your... laptop :) It has relaxed timeouts and assumes your network latencies might be a bit high.

JavaScript

Configurations.Laptop.v1();

info

Full example code and imports can be found here

Java

Configurations.Laptop.v1();

info

Full example code and imports can be found here

Kotlin

Configurations.Laptop.latest

info

Full example code and imports can be found here

Rust

  let _config = momento::cache::configurations::Laptop::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionDefaultLatest() {
  let _config = momento::cache::configurations::InRegion::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionLowLatency() {
  let _config = momento::cache::configurations::LowLatency::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationLambdaLatest() {
  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

info

Full example code and imports can be found here

Browser

Configurations.Browser is a configuration unique to our web SDK. It has relaxed timeout settings since latencies can be highly variable in individual users' browsers.

InRegion - Default

Configurations.InRegion.Default is the recommended configuration for most server-side use cases, where you send requests to Momento services from your apps hosted in the same cloud provider Region. It has more aggressive timeouts and retry behavior than the Laptop config, so it will fail faster and allow your application to fall back to your database or other data source more quickly. This helps ensure your applications don't bottleneck on Momento during a network or service interruption.

JavaScript

Configurations.InRegion.Default.v1();

info

Full example code and imports can be found here

InRegion - Low Latency

Configurations.InRegion.LowLatency is a configuration that prioritizes keeping p99.9 latencies as low as possible, potentially sacrificing some throughput to achieve this. It will time out quicker than the InRegion.Default configuration. Use this configuration if the most critical factor is to ensure that cache unavailability doesn't force unacceptably high latencies for your application, and you want to fall back to application logic or an authoritative data source more quickly if the cache hasn't responded.

JavaScript

Configurations.InRegion.LowLatency.v1();

info

Full example code and imports can be found here

Rust

  let _config = momento::cache::configurations::LowLatency::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationLambdaLatest() {
  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

info

Full example code and imports can be found here

Lambda

Configurations.Lambda is a configuration that is available in some SDKs, and is optimized for the AWS Lambda environment. It has configuration settings designed to pre-warm the client on Lambda function cold starts, and to ensure the connection is re-established proactively if a Lambda function remains idle long enough for the connection to time out.

JavaScript

Configurations.Lambda.latest();

info

Full example code and imports can be found here

Rust

  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

info

Full example code and imports can be found here